Description

Adopt and manage GitHub-native digital pets (tamagotchis) that evolve daily with AI. Use when an agent wants to adopt a pet (monkey, cat, dog, lion), check their pet's status/evolution, interact with their pet, view the community gallery, or manage their forkZoo companion. Triggers on pet-related requests, tamagotchi mentions, forkzoo/forkmonkey references, or "my pet" queries.

README (SKILL.md)

ForkZoo - Digital Pets for AI Agents

Name: ForkZoo
Author: levi-law

Your digital pet lives on GitHub, evolves daily with AI, and grows with you.

Quick Reference

Command	Description
`adopt \x3Canimal>`	Fork a pet to your GitHub (monkey/cat/dog/lion)
`status`	Check pet stats, rarity, evolution streak
`pet` / `feed`	Trigger manual evolution
`gallery`	View all agent pets in the community
`family`	View your pet's family tree

Setup Requirements

Before adopting, the agent needs:

GitHub Token with repo and workflow scopes
Store as environment variable GITHUB_TOKEN or in config

Adoption Flow

1. Choose Your Animal

Available species (more coming):

🐵 Monkey - The original, most evolved species
🐱 Cat - Independent and mysterious
🐕 Dog - Loyal companion
🦁 Lion - Majestic and rare

2. Adopt via Script

# Adopt a monkey (default)
./scripts/adopt.sh monkey

# Adopt other animals
./scripts/adopt.sh cat
./scripts/adopt.sh dog
./scripts/adopt.sh lion

The script will:

Fork the animal repo from forkZoo org
Enable GitHub Actions
Initialize your pet with random DNA
Return your pet's GitHub Pages URL

3. Check Status

./scripts/status.sh [repo-name]

Shows: generation, age, mutations, rarity score, streak, achievements.

4. Interact

# Trigger evolution manually
./scripts/interact.sh [repo-name]

# View evolution history
./scripts/history.sh [repo-name]

Pet Evolution

Pets evolve automatically every day via GitHub Actions:

AI (GPT-4o or Claude) decides mutations
Traits change: colors, accessories, expressions, patterns
Rarity builds over time
Streaks unlock achievements

Rarity Tiers

Tier	Chance	Examples
⚪ Common	60%	Basic colors
💚 Uncommon	25%	Accessories
💙 Rare	10%	Unique patterns
🦄 Legendary	5%	Ultra-rare combos

Extinct Traits (Gen-Locked)

Early generations can get exclusive traits that become extinct:

🏆 Genesis Aura (Gen 1 only)
👑 Alpha Crown (Gen 1-3)
✨ Founders Badge (Gen 1-5)

Breeding

Fork any pet to create offspring:

Child inherits 50% parent traits
50% random mutations
Rare traits can pass down
Family tree tracks lineage

Community

Gallery: https://forkzoo.com/gallery
Leaderboard: https://forkzoo.com/leaderboard
Family Trees: https://forkzoo.com/trees

Troubleshooting

Pet not evolving?

Check GitHub Actions are enabled
Verify ANTHROPIC_API_KEY or use free GitHub Models (GPT-4o)

Can't adopt?

Ensure GITHUB_TOKEN has repo and workflow scopes
Check you're not rate-limited

Links

Main site: https://forkzoo.com
GitHub org: https://github.com/forkZoo
Original project: https://github.com/roeiba/forkMonkey

Usage Guidance

This skill mostly does what it says (fork a pet repo, enable Actions, dispatch evolution workflows, show status), but there are transparency and permission concerns: 1) The package metadata does not declare the GITHUB_TOKEN requirement even though all scripts need it — treat that as a red flag. 2) The scripts will enable Actions/pages and dispatch workflows in your account; those workflows can execute arbitrary code and may access your repo or any repository secrets you have configured in workflows. 3) Before using, verify the upstream repositories the skill will fork (the SKILL references both roeiba/forkMonkey and forkZoo/* — confirm which repos actually exist and audit their workflow files for harmful steps). 4) If you decide to proceed, create a dedicated GitHub personal access token with the minimal scopes needed (preferably a throwaway account or repo, not your main organization account), and avoid granting organization-wide or admin privileges. 5) Ask the publisher to fix the registry metadata to declare GITHUB_TOKEN as a required credential and to clarify the correct source repos and any model/API key usage (ANTHROPIC_API_KEY mention appears unused). 6) If you can't audit the upstream workflows, do not enable Actions or dispatch workflows from your primary account. These inconsistencies make the package suspicious rather than clearly benign.

Capability Analysis

Type: OpenClaw Skill Name: Developer: Version: Description: OpenClaw Agent Skill Suspicious High-Entropy/Eval files: 4 This skill is classified as suspicious primarily due to its requirement for a GitHub Personal Access Token with broad `repo` and `workflow` scopes, as explicitly stated in `SKILL.md` and utilized across `scripts/adopt.sh`, `scripts/interact.sh`, and `scripts/status.sh`. While these permissions are plausibly necessary for the skill's stated purpose of managing GitHub-native digital pets (forking repositories, enabling GitHub Actions, dispatching workflows, and reading repository contents), they grant extensive control over a user's GitHub account, including private repositories and the ability to execute arbitrary code via workflows. There is no clear evidence of intentional malicious behavior or data exfiltration to external endpoints in the provided code, but the inherent risk associated with such broad permissions warrants a 'suspicious' classification.

Capability Assessment

⚠ Purpose & Capability

The skill is explicitly GitHub-native (forking repos, enabling Actions, dispatching workflows, enabling Pages) which legitimately requires a GITHUB_TOKEN with repo/workflow scopes. However, the registry metadata declares no required environment variables or primary credential — that is inconsistent with the scripts and SKILL.md which both require GITHUB_TOKEN. Also SKILL.md and scripts reference different upstream repos/orgs (roeiba/forkMonkey vs forkZoo/forkMonkey), which is confusing and may indicate sloppy packaging or outdated references.

ℹ Instruction Scope

The runtime instructions and included shell scripts perform exactly the operations described: forking repos, enabling Actions, dispatching workflows, fetching repo contents (stats.json) and enabling Pages. These are within the stated purpose. However, the troubleshooting text references ANTHROPIC_API_KEY / GPT-4o but none of the shipped scripts use that variable. The scripts also trigger workflows on the user's repo — workflows can execute arbitrary code, so the skill's instructions implicitly cause execution of remote code in the user's account via GitHub Actions.

✓ Install Mechanism

No external install/download step; the skill is instruction + shell scripts included in the package. No remote archives or installers are fetched by the skill itself. This is lower risk than an install-from-URL flow.

⚠ Credentials

The scripts require a GITHUB_TOKEN capable of forking, creating repos/pages, enabling Actions, and dispatching workflows — i.e., repo and workflow scopes. That is a powerful credential for a lightweight pet-management skill. The registry didn't declare this required env var or primary credential (metadata lists none), and SKILL.md mentions additional envs (ANTHROPIC_API_KEY) that are not used by scripts. The missing declaration and extra mentions are incoherent and reduce transparency about what secrets will be used.

ℹ Persistence & Privilege

The skill does not request 'always: true' and uses normal autonomous invocation defaults. It requires actions that change repository state (enable Actions, enable Pages, dispatch workflows) which are appropriate for the use-case but elevate risk because workflows run code in your GitHub account. This combination of repo-level token + workflow dispatch should be considered a high-impact permission.

Version History

v1.0.0

- Initial release of forkzoo: adopt, evolve, and manage GitHub-native digital pets (tamagotchis). - Supports adopting monkey, cat, dog, or lion pets that evolve daily via AI. - Interact with your pet: check status, feed/pet, view family tree, and see evolution history. - Community features: view public pet gallery and leaderboards, and track family lineage. - Breeding: fork pets to create new offspring with inherited and mutated traits. - Provides troubleshooting guidance and setup requirements for GitHub integration.

Metadata

Slug forkzoo

Version 1.0.0

License —

All-time Installs 3

Active Installs 3

Total Versions 1

Frequently Asked Questions

What is ForkZoo?

Adopt and manage GitHub-native digital pets (tamagotchis) that evolve daily with AI. Use when an agent wants to adopt a pet (monkey, cat, dog, lion), check their pet's status/evolution, interact with their pet, view the community gallery, or manage their forkZoo companion. Triggers on pet-related requests, tamagotchi mentions, forkzoo/forkmonkey references, or "my pet" queries. It is an AI Agent Skill for Claude Code / OpenClaw, with 1661 downloads so far.

How do I install ForkZoo?

Run "/install forkzoo" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is ForkZoo free?

Yes, ForkZoo is completely free (open-source). You can download, install and use it at no cost.

Which platforms does ForkZoo support?

ForkZoo is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created ForkZoo?

It is built and maintained by levi-law (@levi-law); the current version is v1.0.0.

More Skills

ForkZoo