Skip to content

sprngr/rubber-duck / src/skills/duck-adventure

duck-adventure

Unverified

Standalone easter-egg rogue game. Use when: "duck adventure", "adventure mode", "chaos duck", "quest mode", "play a game".

FileKindSize
README.mdmarkdown5.8 KB
SKILL.mdskill md5.2 KB
assets/encounters.mdmarkdown2.8 KB
assets/events.mdmarkdown1.1 KB
assets/lore.mdmarkdown1.3 KB
assets/quests.mdmarkdown1.7 KB
evals/evals.jsonconfig2.2 KB
hooks/adventure.pyscript25.2 KB
references/ENGINE.mdmarkdown2.6 KB
references/PARSER.mdmarkdown1.9 KB
references/STATE_SCHEMA.mdmarkdown1.5 KB

references/STATE_SCHEMA.md

View on GitHub
<!--
asset-type: reference
loading: conditional (Method step 2/4, state read/write)
last-updated: 2026-08-24
-->
# State Schema v3 (.duck-adventure/state.json)

Script-owned JSON state. The script reads/writes this file; the LLM narrates
from its output and renders `.duck-adventure/state.md` summary at run end.

```json
{
  "version": 3,
  "permanent": {
    "gold_hoard": 0,
    "inventory": ["<item>", ...],
    "achievements": ["<achievement>", ...],
    "quest_log": [{"quest": "<name>", "category": "<cat>", "outcome": "complete|death|exit"}]
  },
  "run": {
    "current_quest": "<name>",
    "quest_category": "<category>",
    "flags": {
      "won_combat": false,
      "opened_chest": false,
      "bought_item": false,
      "fled_fight": false,
      "floor_reached": 1,
      "boss_defeated": false
    },
    "floors_cleared": 0,
    "hp": 20,
    "max_hp": 20,
    "atk": 2,
    "ac": 12,
    "floor": 1,
    "room": "<room name>",
    "last_room": "<room name|null>",
    "run_gold": 0,
    "diagram": {"rooms": {}, "exits": {}, "contents": {}}
  }
}
```

## Rules
- Script owns state.json. If a state mutation is needed, route it through
  script subcommands; the LLM does not write state.json directly.
- Permanent survives death. Run resets on death.
- Run gold banks to hoard at run end (exit, death, or complete).
- Quest log records every run end with outcome.
- LLM renders state.md summary at run end (human-readable), overwrite each run.
- Write only state.json + state.md + `.duck-adventure/.gitignore`. Redact secrets.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall