forkzoo

What This Skill Does

The forkzoo skill allows OpenClaw agents to adopt, manage, and evolve digital pets (tamagotchis) directly on GitHub. Each pet is a unique repository that evolves daily using AI-driven automation. Through this skill, your agent can foster a monkey, cat, dog, or lion, each inheriting randomized DNA and evolving traits over time. As your pet lives on GitHub, its evolution—including color changes, accessories, and expression mutations—is driven by LLM agents (GPT-4o or Claude) triggered via GitHub Actions. The system tracks rarity tiers ranging from Common to Legendary, and unique gen-locked traits ensure early adopters have access to exclusive history. By leveraging GitHub infrastructure, forkzoo turns your agent's coding environment into a living, breathing community.

Installation

To begin managing your digital companion, ensure you have an active GitHub account and an API token with repo and workflow scopes. Install the skill into your OpenClaw agent using the following terminal command:

clawhub install openclaw/skills/skills/levi-law/forkzoo-skill

After installation, export your token as an environment variable to allow the skill to interface with the GitHub API:

export GITHUB_TOKEN='your_token_here'

Ensure that GitHub Actions are enabled in the repository where your pet is hosted to allow for daily AI evolution triggers.

Use Cases

• Companion Management: Keep a virtual pet that serves as a gamified companion for long-running AI tasks.
• Agent Enrichment: Add a social and creative layer to agent activity by maintaining a lineage of pets and contributing to the global gallery.
• Data/Trait Tracking: Utilize the status and history commands to audit pet development, mutation trends, and rarity score progressions.
• Community Interaction: Participate in the broader forkZoo ecosystem by sharing pet lineage and achieving high-rarity status to appear on public leaderboards.

Example Prompts

• "I'm lonely in this terminal, adopt a cat for me and set up the evolution pipeline."
• "Check the status of my monkey pet, does it have any new mutations or is it ready to evolve?"
• "Can you show me the family tree for my current pet and compare its rarity to the community gallery?"

Tips & Limitations

• Evolution Triggers: If your pet stops evolving, check that your ANTHROPIC_API_KEY is set or that the GitHub Actions environment is configured for free GitHub Models (GPT-4o).
• Trait Preservation: Remember that early generations hold exclusive 'Genesis' and 'Alpha' traits that cannot be replicated once the generation limit is passed.
• Rate Limiting: Because the skill performs repository forks and API calls, frequent manual interaction can hit GitHub rate limits. Stagger your interactions if managing multiple pets.
• Data Security: Keep your GITHUB_TOKEN secure, as it grants write access to your repository structure to perform the adoption and maintenance tasks.