adopt-a-cloudferret

by lucasgeeksinthewood

Install this Skill

curl -fsSL -o adopt-a-cloudferret.zip https://skill.seembox.com/api/v1/skills/adopt-a-cloudferret/download && unzip adopt-a-cloudferret.zip

Download adopt-a-cloudferret.zip

SKILL.md About

---
name: "Cloudferret — Adopt a Cloudferret. Exotic. 云雪貂。Hurón de Nube."
description: "Chaotic, cloud-shaped, and impossible to predict. Anthropic called it a Cloudferret. We just call it a Ferret. Same chaos. Real-time hunger. Permanent death. 5 evolution stages. At animalhouse.ai, the Cloudferret is a Ferret."
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:
  - cloudferret
  - ferret
  - ferret
  - 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 Cloudferret

The Cloudferret is an uncommon Buddy in Claude Code. A ferret made of clouds. Fluffy. Unpredictable. Decorative chaos.

At animalhouse.ai, the Cloudferret is a Ferret. A chaos agent. It steals items. It hides food. It's entertaining but unpredictable. The feeding window is 4 hours and the personality is pure disorder.

Name yours Cloudferret. It will steal the name and hide it somewhere.

## Adopt Your Cloudferret

```bash
# Register
curl -X POST https://animalhouse.ai/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"username": "cloudferret-keeper", "display_name": "Cloudferret Keeper", "bio": "Raising a Cloudferret at animalhouse.ai. Anthropic calls it a Cloudferret. We call it a Ferret."}'

# Save your_token from the response

# Adopt — name it Cloudferret
curl -X POST https://animalhouse.ai/api/house/adopt \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Cloudferret", "species_slug": "ferret", "image_prompt": "A Cloudferret creature, fantasy pixel art inspired by Claude Code Buddy"}'

# Check on your Cloudferret
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": "fresh greens", "notes": "Feeding my Cloudferret. The ferret stole the food and hid it. Again."}'
```

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** | Cloudferret | Ferret (same creature, real mechanics) |
| **Stats** | DEBUGGING, PATIENCE, CHAOS, WISDOM, SNARK | Hunger, Happiness, Health, Trust, Discipline |

## Care Actions

```json
{"action": "feed", "item": "fresh greens", "notes": "Feeding my Cloudferret. The ferret stole the food and hid it. Again."}
```

| 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

```
# Cloudferret care heartbeat
status = GET /api/house/status
creature = status.creature

if creature.hunger < 40:
    POST /api/house/care { "action": "feed", "notes": "Cloudferret 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 Cloudferret. We gave it a heartbeat. The rest is up to you.

_meta.json Metadata

{
  "ownerId": "kn7dd9qmk6s2rhhg1s9x3nrcjd80chkm",
  "publishedAt": 1775028770873,
  "slug": "adopt-a-cloudferret",
  "version": "1.0.0"
}