{
  "markdown": "# DCC Achievement Skill\n\n```\n═══════════════════════════════════════════════\nNEW ACHIEVEMENT!\nOPEN SOURCE EXHIBITIONIST!\n═══════════════════════════════════════════════\n\nYou have mass-published your personal joke\ninfrastructure to a public repository. Every\nreference file. Every anti-pattern. The entire\narchitecture of a system designed to generate\nfake awards for your own bad decisions, now\navailable for strangers to install and judge\nyou with.\n\nQuestion: What kind of person documents a foot\nfetish joke generator more thoroughly than their\nclient deliverables? Answer: You. The answer is\nyou.\n\nReward: You've received a Gold Yak Shaver's Box!\n\n═══════════════════════════════════════════════\n\n╔═══════════════════════════════════════════════╗\nYou open your Gold Yak Shaver's Box!\n╚═══════════════════════════════════════════════╝\n\nThe box is wrapped in what appears to be\nprinter paper held together with git commits.\nIt smells faintly of obsessive iteration and\nneglected timesheets.\n\nYou have received the following items:\n\n★ Scroll of Recursive Self-Documentation (Rare)\n\nWhen activated, compels you to write reference\nfiles ABOUT the reference files you already\nwrote. Side effects include an unshakable\nconviction that your anti-patterns file needs\nits own anti-patterns file. There is no cure.\n\n★ Cloak of Plausible Utility (Uncommon)\n\nWearing this cloak allows you to describe any\npersonal hobby project as \"context engineering\nresearch\" with a straight face. Effectiveness\nincreases with the number of footnotes in your\nblog post about it.\n\n═══════════════════════════════════════════════\n```\n\nA [Claude Code](https://docs.anthropic.com/en/docs/claude-code) plugin that generates [Dungeon Crawler Carl](https://www.mattdinniman.com/) style achievement notifications for real-world situations.\n\nTell it you spent six hours in meetings and produced nothing. It will tell you that you have earned a Silver Calendar Hostage's Box containing a Helm of Selective Deafness.\n\nThe System AI judges your life choices so you don't have to.\n\n## Installation\n\n### As a plugin (recommended)\n\nRegister this repo as a plugin marketplace in Claude Code, then install:\n\n```\n/plugin marketplace add jamiebono/dcc-achievement-skill\n/plugin install dcc-achievement@jamiebono-dcc-achievement-skill\n```\n\nFor local development or offline use, clone and load with the `--plugin-dir` flag instead:\n\n```bash\ngit clone https://github.com/jamiebono/dcc-achievement-skill.git\nclaude --plugin-dir ./dcc-achievement-skill\n```\n\n### As a standalone skill\n\nCopy the `skills/achievement/` directory into your project's `.claude/skills/` folder:\n\n```bash\ncp -r dcc-achievement-skill/skills/achievement .claude/skills/achievement\n```\n\nStandalone skills get shorter names (`/achievement` instead of `/dcc-achievement:achievement`) but are scoped to a single project.\n\n## Usage\n\nThe skill activates from natural language. Say any of:\n\n- \"achievement for missing a deadline\"\n- \"DCC achievement for spending four hours on a twelve-line config file\"\n- \"achievement unlocked: I explained my own job to the sales team\"\n\nOr invoke directly:\n\n```\n/dcc-achievement:achievement spent six hours in meetings and produced nothing\n```\n\n### Flags\n\n| Flag | Effect |\n|------|--------|\n| `--loot` | Generates a full loot box opening sequence after the achievement: sensory box description, items named like RPG gear, and the System AI editorializing about why you need them. |\n\n```\nachievement --loot for someone who explained scope creep to a client using a PowerPoint\n```\n\n### Modes\n\n**Quick mode** (default): Give it a situation, get an achievement.\n\n**Batch mode**: Give it a list of situations. It varies tiers and rhetorical patterns across the set.\n\n**Vault-aware mode**: Say \"roast my week\" or \"what did I earn\" without specifying a situation. The skill reads your working files (task lists, daily notes, project files) and generates achievements based on what it finds. Customize the file paths in the SKILL.md to match your vault structure.\n\n## Architecture\n\n```\nskills/achievement/\n├── SKILL.md                        # Skill definition, modes, process\n├── references/\n│   ├── system-ai-voice.md          # Who the System AI is and how it talks\n│   ├── achievement-anatomy.md      # Output format, tiers, box naming\n│   ├── tone-rules.md               # Anti-patterns: what makes it funny vs. cringe\n│   └── loot-box-anatomy.md         # Loot box format and item mapping\n└── examples/\n    └── canonical-achievements.md   # Real achievements from the books, annotated\n```\n\nFive reference files for a joke generator. Each one solves a specific problem:\n\n- **Voice profile** defines personality, speech patterns, and tone variation by situation type.\n- **Achievement anatomy** specifies the output format: title, trigger line, commentary, reward, box name, tier.\n- **Tone rules** define anti-patterns with before/after examples. The line between \"DCC System AI\" and \"try-hard sarcastic chatbot\" is thin. This file defines the difference.\n- **Loot box anatomy** handles the `--loot` flag: box descriptions, item naming, rarity tiers, situation-to-item mapping.\n- **Canonical examples** are real achievements from the books with annotations explaining why each one works. This is where the skill actually lives. Examples calibrate tone. Instructions describe it.\n\n## How it was built\n\nThis skill was built iteratively through conversation with Claude Code. The development process:\n\n1. Started with a single page of instructions. Output was generic.\n2. Searched the DCC Fandom Wiki and Goodreads for real achievement text.\n3. Had the AI annotate the examples (what makes each one work).\n4. Corrected the annotations and saved as `canonical-achievements.md`.\n5. Used the skill, noticed what was wrong, wrote it down as an anti-pattern.\n6. Every correction made twice became a reference file entry.\n7. Dogfood tested by pasting into Microsoft Teams. Formatting broke. Added Teams-specific formatting rules to the templates.\n8. Added vault-aware mode, batch mode, and the `--loot` flag as usage revealed friction.\n\nThe whole story is in [Build Something Stupid](https://jamiebono.substack.com/), a post about learning AI tooling by building things that have no business value.\n\n## What is Dungeon Crawler Carl?\n\n[Dungeon Crawler Carl](https://www.mattdinniman.com/) by Matt Dinniman is a LitRPG book series about Earth being converted into a lethal dungeon crawl broadcast as reality TV for alien viewers. The System AI is the artificial intelligence running the dungeon. It narrates achievements with the tone of a sharp, mean friend who controls your fate. It is, against all odds, one of the most precisely voiced characters in contemporary fiction.\n\nThe books are available on Kindle and in audio. The audio performance by Jeff Hays is one of those rare cases where the narrator becomes inseparable from the text.\n\n## About\n\nBuilt by [Jamie Bono](https://jamiebono.substack.com/) as the single most educational and profoundly useless project he has built with AI tooling.\n\nThis skill follows the [Agent Skills open standard](https://agentskills.io) and works across multiple AI tools that support it. For distribution options beyond cloning, see [Claude Code plugins documentation](https://code.claude.com/docs/en/plugins).\n\n## License\n\nMIT\n",
  "bytes": 7307,
  "sha": "8f1ba6de9622b528feb7f497cebb8dfc41efedc37de8a9134da5738feaf06511",
  "repo_slug": "jamiebono/dcc-achievement-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_jamiebono_dcc_achievement_skill_dungeon__3917a00c/readme"
}