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

Do not install or run this skill until you inspect the included scripts and confirm their behavior. Actions to take before granting any credentials: - Manually open scripts/adopt.sh, status.sh, interact.sh, gallery.sh and verify each network call, destination domain(s), and commands they run (look for curl/gh/ssh/git/remote adds/executions). - Confirm which external endpoints are contacted (forkzoo.com, api.github.com, anthropic/openai endpoints, or any other domains) and whether any data is transmitted off your account. - If you must provide credentials, use least-privilege tokens: avoid full repo/workflow scopes unless absolutely required; prefer a narrowly scoped GitHub App or token with minimal repo access and expire/revoke it after testing. - The registry metadata did NOT declare required env vars (GITHUB_TOKEN, ANTHROPIC_API_KEY), nor required binaries (gh/curl/jq). That mismatch is a red flag—ask the publisher to update metadata or provide an audited manifest. - Consider running the scripts in a sandboxed environment (throwaway account) to observe behavior before linking real accounts. - If you don't want the agent to act autonomously, set disableModelInvocation:true or ensure the skill is user-invocable only. If the author/host is not verifiable (homepage/source unknown), treat credential requests as higher risk. Overall: the functionality is internally plausible, but the undeclared credential requirements, included executable scripts, and missing metadata create coherence concerns — inspect the code and limit credentials before use.

Capability Analysis

Type: OpenClaw Skill Name: Developer: Version: Description: OpenClaw Agent Skill Suspicious High-Entropy/Eval files: 4 The OpenClaw skill bundle is classified as benign. While it requires a GitHub token with broad `repo` and `workflow` scopes, these permissions are explicitly declared in `SKILL.md` and are necessary for the skill's stated purpose of adopting and managing GitHub-native digital pets (e.g., forking repositories, enabling GitHub Actions, dispatching workflows, setting up GitHub Pages). The scripts (`adopt.sh`, `interact.sh`, `status.sh`, `gallery.sh`) only interact with `api.github.com` and related legitimate project domains, without any evidence of data exfiltration to unauthorized endpoints, malicious execution, persistence mechanisms, or prompt injection attempts against the AI agent.

Capability Assessment

✓ Purpose & Capability

Managing GitHub-native pets reasonably requires a GitHub token and the ability to fork repos/enable Actions; that aligns with the skill's description.

⚠ Instruction Scope

SKILL.md explicitly instructs running included shell scripts that fork repos, enable Actions, and return GitHub Pages URLs. It also mentions use of AI models (GPT-4o/Claude) and an optional ANTHROPIC_API_KEY for evolution — none of these extra credentials or model calls are declared in the registry metadata. The instructions ask the agent to perform network actions on the user's GitHub account and possibly call external AI services, which broadens scope beyond the simple tamagotchi description.

ℹ Install Mechanism

No install spec is provided (instruction-only), but several executable scripts are included in the package. That mismatch is notable: the skill will rely on local script execution even though no required binaries or installation steps are declared. Expect the scripts to call system tools (curl, jq, gh) and the network.

⚠ Credentials

SKILL.md requires a GITHUB_TOKEN with repo and workflow scopes and mentions ANTHROPIC_API_KEY / model access; however, the registry lists no required environment variables or a primary credential. Asking for a GitHub token with repo+workflow scope is expected for this functionality, but the omission from the metadata is a discrepancy and the additional AI-service key mention increases credential scope without justification.

ℹ Persistence & Privilege

The skill does not set always:true and does not disable model invocation, so an agent could call it autonomously. If you supply a GITHUB_TOKEN, that means the model could perform GitHub operations on your behalf without further user confirmation. Consider disabling autonomous invocation or restricting token scopes if you install it.

Version History

v1.0.0

Initial release of forkzoo. - Adopt and manage digital pets (monkey, cat, dog, lion) on GitHub. - Pets evolve daily with AI, gaining new traits and rarity. - Interact with your pet, check status and evolution history. - Includes community gallery, leaderboard, and family tree features. - Breeding system lets pets create offspring with inherited traits.

Metadata

Slug forkzoo-skill

Version 1.0.0

License —

All-time Installs 1

Active Installs 1

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 1443 downloads so far.

How do I install ForkZoo?

Run "/install forkzoo-skill" 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