{
  "markdown": "# The Builder's Handbook (TBH): Build-Along Companion for Claude\n\nA Claude Code plugin that guides you through building real systems alongside [The Builder's Handbook](https://github.com/tbhbooks) book series.\n\ntbh, you should build it yourself — and this plugin makes sure you can.\n\n## Install\n\n```bash\n# In Claude Code: Execute following two commands\n/plugin marketplace add tbhbooks/tbh-skill \n/plugin install tbh@the-builders-handbook\n```\n\nOr load locally for development:\n```bash\nclaude --plugin-dir ./tbh/tbhbooks-skill\n```\n\n## Quick Start\n\n```\n/tbh:setup            # Pick a book, set your language\n/tbh:build-chapter    # Start building the current chapter\n/tbh:validate         # Run tests against your implementation\n/tbh:hint             # Get a nudge when you're stuck\n/tbh:next             # See what's next\n```\n\n## All Commands\n\n| Command | What it does |\n|---------|-------------|\n| `/tbh:setup` | Pick a book, set language, initialize environment |\n| `/tbh:switch` | Switch between books (preserves progress) |\n| `/tbh:status` | Show active book + chapter progress |\n| `/tbh:build-chapter [N]` | Start/continue a chapter's build |\n| `/tbh:validate [N]` | Run chapter validation tests |\n| `/tbh:hint [topic]` | Targeted hint without spoilers |\n| `/tbh:review [N]` | Review implementation against spec |\n| `/tbh:explain <concept>` | Explain a concept grounded in your code |\n| `/tbh:next` | What to do next based on progress |\n\n## Available Books\n\nBooks are fetched from the [registry](https://github.com/tbhbooks/tbh-skill/blob/main/books/registry.json) — new books appear automatically, no plugin update needed.\n\n| Book | Title | Status |\n|------|-------|--------|\n| `agents` | The Builder's Handbook: Agents That Think and Self-Improve | Draft Ready |\n\n## How It Works\n\n```\n┌─────────────────────────────────────────────────┐\n│  GitHub (source of truth)                       │\n│                                                 │\n│  tbhbooks/tbh-skill/books/registry.json         │\n│    → lists all available books                  │\n│                                                 │\n│  tbhbooks/<book-repo>/spec/ch01/...             │\n│    → chapter specs, interfaces, tests           │\n│  tbhbooks/<book-repo>/chapters/ch01.md          │\n│    → chapter content                            │\n└──────────────────┬──────────────────────────────┘\n                   │ curl (on each skill run)\n                   ▼\n┌─────────────────────────────────────────────────┐\n│  Reader's project                               │\n│                                                 │\n│  .tbh/config.json      ← active book + state    │\n│  .tbh/progress.json    ← per-book completion    │\n│  .tbh/cache/           ← fetched content cache  │\n│    ch03_interface-spec.md                       │\n│    ch03_prompt-template.md                      │\n│    validation/test_ch03.py                      │\n└─────────────────────────────────────────────────┘\n```\n\n1. `/tbh:setup` fetches the book registry from GitHub, lets you pick a book, creates `.tbh/` state\n2. Every skill fetches the files it needs from GitHub raw URLs, caches them locally\n3. If offline, skills fall back to cached content\n4. Progress is tracked per-book — switch freely without losing state\n5. New books or chapter updates on GitHub are picked up automatically\n\n## Adding a New Book\n\nAdd an entry to `books/registry.json`:\n\n```json\n{\n  \"id\": \"my-new-book\",\n  \"title\": \"The Builder's Handbook: My New Book\",\n  \"description\": \"...\",\n  \"status\": \"draft\",\n  \"total_chapters\": 10,\n  \"default_language\": \"python\",\n  \"repo\": \"https://github.com/tbhbooks/my-new-book\",\n  \"raw_base\": \"https://raw.githubusercontent.com/tbhbooks/my-new-book/main\",\n  \"spec_path\": \"spec\",\n  \"chapters_path\": \"chapters\"\n}\n```\n\nThat's it. Every reader's next `/tbh:setup` or `/tbh:switch` will see it.\n\n## Philosophy\n\n- **Guide, don't solve.** The plugin helps you build — it doesn't build for you.\n- **Spec is the source of truth.** Every hint, review, and validation points back to the chapter spec.\n- **Progressive hints.** First nudge is directional, second is specific, third shows pseudocode skeleton.\n- **Language-agnostic.** You pick your language. Specs describe interfaces, not implementations.\n- **Always fresh.** Content is fetched from GitHub — you always get the latest specs and tests.\n",
  "bytes": 4337,
  "sha": "9aec5daf72d113ab4f2c8cf82dbc36c2b0c511a944bf5abdee21cd7a328bb46a",
  "repo_slug": "tbhbooks/tbh-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_tbhbooks_tbh_skill_tbh_79c5ae98/readme"
}