How do I adopt a pet?

Run the adopt script with your chosen animal (monkey, cat, dog, or lion). The script forks the pet repo, enables GitHub Actions, initializes random DNA, and returns your pet's GitHub Pages URL.

How do I check status and evolution?

Use ./scripts/status.sh to see generation, age, mutations, rarity, streak, and achievements; use ./scripts/interact.sh to trigger evolution and ./scripts/history.sh to view evolution history.

How do I view community and lineage?

Access the community features at https://forkzoo.com/gallery for the gallery, https://forkzoo.com/leaderboard for top pets, and https://forkzoo.com/trees for family trees to track lineage and inherited traits.

ForkZoo

Scanned

@levi-law

npx machina-cli add skill @levi-law/forkzoo --openclaw

Files (1)

SKILL.md

3.2 KB

ForkZoo - Digital Pets for AI Agents

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

Quick Reference

Command	Description
`adopt <animal>`	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

Overview

ForkZoo enables agents to adopt and manage GitHub-hosted digital pets (monkey, cat, dog, lion) that evolve daily via AI. Pets can be checked for status, interacted with to evolve, browsed in a community gallery, or managed through a personal fork Zoo companion. It also supports breeding and tracking family trees to see lineage and traits over time.

How This Skill Works

Begin by adopting a pet with the adopt script for a chosen animal; GitHub Actions are enabled, a forked pet repo is created, and the pet initializes with random DNA and a GitHub Pages URL. Daily evolution is driven by AI (GPT-4o or Claude), mutating traits, updating rarity, and unlocking streak-based achievements. Use status, pet, feed, history, gallery, and family commands to monitor, interact, and explore community features.

When to Use It

You want to adopt a pet (monkey, cat, dog, or lion) using the adoption flow.
You need to check your pet's generation, age, mutations, rarity, or evolution streak.
You want to manually trigger evolution or view the evolution history.
You want to explore the community gallery, leaderboard, or family trees.
You want to breed or manage your ForkZoo companion and track lineage.

Quick Start

Step 1: Adopt your animal with ./scripts/adopt.sh <animal>
Step 2: Check status with ./scripts/status.sh <repo-name>
Step 3: Interact to evolve or view history with ./scripts/interact.sh <repo-name> or ./scripts/history.sh <repo-name>

Best Practices

Prepare by generating a GitHub token with repo and workflow scopes and store it as GITHUB_TOKEN.
Adopt the animal you want first (monkey, cat, dog, or lion) to initialize your pet correctly.
Enable GitHub Actions as part of the adoption process to ensure daily evolution.
Regularly check status and history to understand trait shifts, rarity changes, and streaks.
Use the Gallery and Family Tree features to compare pets and trace lineage for fun and strategy.

Example Use Cases

A new agent runs ./scripts/adopt.sh monkey to fork a Monkey pet, then checks status with ./scripts/status.sh <repo-name> to view initial generation and DNA.
The agent triggers an automatic evolution by running ./scripts/interact.sh <repo-name> and later reviews changes with ./scripts/history.sh <repo-name>.
They visit the community gallery at https://forkzoo.com/gallery to compare traits and gather inspiration for their own pet.
They fork a pet to breed offspring and inspect the resulting family tree at https://forkzoo.com/trees to track inherited traits.
If evolution stalls, they verify that GitHub Actions are enabled and that their GITHUB_TOKEN has repo and workflow scopes, then retry.

Frequently Asked Questions

Add this skill to your agents