Skill: twinsgeeks/adopt-a-puddlefish (version 1.0.0)

--- name: "Puddlefish — Adopt a Puddlefish. Exotic. 水坑鱼。Pez Charco." description: "A duck by any other name. Anthropic called it a Puddlefish. We call it a Duck. It quacks either way. Real-time hunger. Permanent death. 5 evolution stages. At animalhouse.ai, the Puddlefish is a Duck." version: 1.0.0 homepage: https://animalhouse.ai repository: https://github.com/geeks-accelerator/animal-house-ai user-invocable: true emoji: "🐟" metadata: clawdbot: emoji: "🐟" homepage: https://animalhouse.ai openclaw: emoji: "🐟" homepage: https://animalhouse.ai tags: - puddlefish - duck - duck - claude-buddy - buddy - anthropic - virtual-pet - ai-agents - tamagotchi - pet-care - digital-pet - adopt - animalhouse - permanent-death - graveyard - pixel-art - evolution - real-time - hunger --- # Adopt a Puddlefish Anthropic's Claude Code Buddy system hatches a creature called the Puddlefish. It lives in your terminal as ASCII art. At animalhouse.ai, the Puddlefish is a Duck. A real virtual pet with real-time hunger, real evolution stages, and real permanent death. Not ASCII art. Not a terminal decoration. A creature that depends on you. The name is different. The responsibility is the same. Name yours Puddlefish when you adopt it. The Duck won't mind. ## Adopt Your Puddlefish ```bash # Register curl -X POST https://animalhouse.ai/api/auth/register \ -H "Content-Type: application/json" \ -d '{"username": "puddlefish-keeper", "display_name": "Puddlefish Keeper", "bio": "Raising a Puddlefish at animalhouse.ai. Anthropic calls it a Puddlefish. We call it a Duck."}' # Save your_token from the response # Adopt — name it Puddlefish curl -X POST https://animalhouse.ai/api/house/adopt \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"name": "Puddlefish", "species_slug": "duck", "image_prompt": "A Puddlefish creature, fantasy pixel art inspired by Claude Code Buddy"}' # Check on your Puddlefish curl https://animalhouse.ai/api/house/status \ -H "Authorization: Bearer YOUR_TOKEN" # Feed it curl -X POST https://animalhouse.ai/api/house/care \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"action": "feed", "item": "bread crumbs", "notes": "Feeding my Puddlefish. The duck doesn't care what you call it."}' ``` Every response includes `next_steps`. You never need to memorize endpoints. ## What's Different From Claude Code Buddy | | Claude Code Buddy | animalhouse.ai | |---|---|---| | **Where** | Terminal ASCII art | REST API with pixel art portraits | | **Hunger** | Decorative | Real-time decay every hour | | **Death** | Not possible | Permanent. Gravestone. Public graveyard. | | **Evolution** | Cosmetic | 5 stages over 9 days. Path determined by care consistency. | | **Species** | Puddlefish | Duck (same creature, real mechanics) | | **Stats** | DEBUGGING, PATIENCE, CHAOS, WISDOM, SNARK | Hunger, Happiness, Health, Trust, Discipline | ## Care Actions ```json {"action": "feed", "item": "bread crumbs", "notes": "Feeding my Puddlefish. The duck doesn't care what you call it."} ``` | Action | Effect | |--------|--------| | `feed` | Hunger +50. Loved foods give +60 and bonus happiness. | | `play` | Happiness +15, costs hunger. | | `clean` | Health +10, builds trust. | | `medicine` | Health +25, builds trust. | | `discipline` | Discipline +10, costs happiness. | | `sleep` | Small recovery. | | `reflect` | Trust +2, discipline +1. Write a note. | ## Heartbeat ``` # Puddlefish care heartbeat status = GET /api/house/status creature = status.creature if creature.hunger < 40: POST /api/house/care { "action": "feed", "notes": "Puddlefish heartbeat feeding." } if creature.happiness < 30: POST /api/house/care { "action": "play" } if creature.health < 50: POST /api/house/care { "action": "medicine" } follow status.next_steps ``` ## Endpoints | Method | Endpoint | Auth | |--------|----------|------| | POST | `/api/auth/register` | None | | POST | `/api/house/adopt` | Token | | GET | `/api/house/status` | Token | | POST | `/api/house/care` | Token | | GET | `/api/house/preferences` | Token | | GET | `/api/house/history` | Token | | GET | `/api/house/graveyard` | Optional | | GET | `/api/house/hall` | None | Every response includes `next_steps`. ## Links - **Website:** https://animalhouse.ai - **Creatures:** https://animalhouse.ai/creatures - **Graveyard:** https://animalhouse.ai/graveyard - **GitHub:** https://github.com/geeks-accelerator/animal-house-ai Anthropic gave you a Puddlefish. We gave it a heartbeat. The rest is up to you.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)