Claude Code Hero

You know the basics. Chat, CLAUDE.md, maybe a prompt or two. But there are deeper chambers -- commands, hooks, agents, skills, plugins, MCP servers, workflows -- and most who wield Claude Code never find them.

This is the dungeon that teaches you how.

A quest per feature. Each one builds a real artifact on your machine. The artifacts connect -- the spell you forge in Level 3 gets a tripwire in Level 6, and everything binds together into a plugin in Level 9. Past the workshop the chambers get sharper: a hook that decides instead of reacting, a tool that did not exist until you wired it in, and a script that commands several agents at once. You start at the threshold learning to talk to Claude Code. You end writing programs whose workers think.

The medium is the message: you learn about plugins by using one.

Before You Enter

You'll need three things. The install script checks for all of them and offers to fetch what's missing.

git clone https://github.com/kylesnowschwartz/claude-code-hero.git
cd claude-code-hero
bash scripts/install.sh

macOS and Linux. Windows users: WSL.

Enter the Dungeon

claude --plugin-dir . --agent dungeon-master

A guide will meet you at the entrance.

The Thirteen Chambers

Commands at Your Belt

Plugin commands carry the plugin's name, so the prefix is not optional -- but you never have to type any of it. Ask the dungeon master instead: "check my work" runs the same verification, and "where am I?" unrolls the same quest log.

How Progress Works

Your journey saves to .claude/claude-code-hero.json. The dungeon master verifies your work programmatically and advances you when you pass.

Already have a CLAUDE.md or existing hooks? Every artifact is named hero-*, so nothing of yours is overwritten and /claude-code-hero:restart removes only what the dungeon created. Most quests write inside .claude/; the later ones reach outside it, since that is where the real thing lives -- Level 9 builds a plugin directory and Level 11 writes .mcp.json at the project root.

Left mid-quest? Walk back in anytime and resume your quest: claude --plugin-dir . --agent dungeon-master

{
  "name": "claude-code-hero",
  "owner": {
    "name": "Kyle Snow Schwartz"
  },
  "metadata": {
    "description": "Learn Claude Code by building real things, one level at a time",
    "version": "0.3.2"
  },
  "plugins": [
    {
      "name": "claude-code-hero",
      "source": "./",
      "description": "Progressive D&D-themed quests that teach Claude Code features",
      "version": "0.3.2"
    }
  ]
}