{"slug":"docs-check","title":"docs-check","summary":"CONTRIBUTOR TOOL - Validate plugin against latest Claude Code documentation. Catches breaking changes, deprecations, discovers new features. Run before releases or periodically. NOT part of the distributed plugin.","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-10-04T15:14:19.476656Z","repo":{"url":"https://github.com/oliver-kriska/claude-elixir-phoenix","stars":560,"forks":44,"license":"MIT","updatedAt":"2026-10-02T04:11:38Z"},"bodyHtml":"<hr>\n<h2>name: docs-check\ndescription: |\nCONTRIBUTOR TOOL - Validate plugin against latest Claude Code documentation.\nCatches breaking changes, deprecations, discovers new features.\nRun before releases or periodically. NOT part of the distributed plugin.\nargument-hint: \"[--quick|--focus=agents|skills|hooks|config]\"</h2>\n<h1>Plugin Documentation Compatibility Check</h1>\n<p>Validates plugin agents, skills, hooks, and config against the latest\nClaude Code documentation to catch breaking changes and discover new features.</p>\n<h2>Usage</h2>\n<pre><code>/docs-check                    # Full validation (all components)\n/docs-check --quick            # Structural checks only (no docs fetch, no tokens)\n/docs-check --focus=agents     # Validate only agents\n/docs-check --focus=skills     # Validate only skills\n/docs-check --focus=hooks      # Validate only hooks\n/docs-check --focus=config     # Validate only plugin.json/marketplace.json\n</code></pre>\n<h2>Architecture (OTP Supervision Pattern)</h2>\n<pre><code>┌─────────────────────────────────────────────────────────────────┐\n│  /docs-check (skill entry point)                                │\n│   │                                                             │\n│   ├─ Step 1: bash scripts/fetch-claude-docs.sh (zero tokens)    │\n│   │          Always fetches all 9 doc pages (~420KB)             │\n│   │                                                             │\n│   └─ Step 2: delegate to orchestrator (reads from cache only)   │\n│       │                                                         │\n│       │  docs-validation-orchestrator (opus)                    │\n│       │                                                         │\n│       │  SCAN → READ CACHE → SPAWN WORKERS → COMPRESS → REPORT │\n│       │   │         │              │             │          │   │\n│       │   ↓         ↓              ↓             ↓          ↓   │\n│       │ inventory  pre-fetched  4 parallel    context    report │\n│       │ plugin     docs-cache   subagents     supervisor       │\n│       │ components              (sonnet)      (haiku)          │\n│       └─────────────────────────────────────────────────────────┘\n└─────────────────────────────────────────────────────────────────┘\n</code></pre>\n<h2>Execution</h2>\n<h3>Step 1: Fetch Docs (Automatic)</h3>\n<p><strong>Always run first.</strong> Downloads all doc pages to cache. Skips pages\nalready cached within 24h. Zero token cost — pure curl.</p>\n<pre><code># --quick mode: skip this step entirely (structural checks only)\n# All other modes: always fetch\nbash scripts/fetch-claude-docs.sh\n</code></pre>\n<h3>Step 2: Delegate to Orchestrator</h3>\n<p>After docs are cached, delegate. The orchestrator reads from cache only\nand crashes if cache files are missing.</p>\n<pre><code>Task(subagent_type: \"docs-validation-orchestrator\")\n</code></pre>\n<p>Pass the user's flags (--quick, --focus) in the prompt.</p>\n<h2>What the Orchestrator Does</h2>\n<ol>\n<li><strong>Inventory</strong> — scan <code>plugins/elixir-phoenix/</code> for existing components</li>\n<li><strong>Read cached docs</strong> — from <code>.claude/docs-check/docs-cache/</code> (never fetches)</li>\n<li><strong>Spawn workers</strong> — one sonnet subagent per component type, in parallel</li>\n<li><strong>Compress</strong> — context-supervisor (haiku) if 3+ workers</li>\n<li><strong>Structural checks</strong> — fast local checks, always run</li>\n<li><strong>Report &amp; Action</strong> — write report, offer PR if issues found</li>\n</ol>\n<h2>Iron Laws</h2>\n<ol>\n<li><strong>Fetch ALL docs upfront</strong> — no conditional fetching, no partial downloads</li>\n<li><strong>Use <code>scripts/fetch-claude-docs.sh</code></strong> — single source of truth for doc fetching</li>\n<li><strong>Workers get docs IN PROMPT</strong> — no runtime fetching</li>\n<li><strong>Workers use sonnet</strong> — opus is wasteful for comparison tasks</li>\n<li><strong>Structural checks always run</strong> — even if docs fetch fails</li>\n<li><strong>Breaking changes are BLOCKERS</strong> — surface prominently</li>\n</ol>\n<h2>References</h2>\n<ul>\n<li><code>references/validation-rules.md</code> — Per-component validation checklists</li>\n<li><code>references/doc-pages.md</code> — Component-to-URL mapping</li>\n</ul>\n","files":[{"path":"references/doc-pages.md","sizeBytes":2280,"isText":true},{"path":"references/validation-rules.md","sizeBytes":5887,"isText":true},{"path":"SKILL.md","sizeBytes":4339,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-10-04T15:15:46.931111Z","sha256":"DFBCC0D99A5219945D8404F9C93FF0F0F702B9A9B70645C8DCA8404118B63765","sizeBytes":5600},"review":null,"source":{"repositoryUrl":"https://github.com/oliver-kriska/claude-elixir-phoenix","path":".claude/skills/docs-check","license":"MIT","commit":"9767a82d24ddddad553e85f88efc2869a7fd7d88","subtreeSha":"EED9C5CE9A02EDBF2892FCEFB2CE29A1EA25D7425AE5E05496BC6CB4AEFB86D4","lastSyncedAt":"2026-10-04T15:14:09.139242Z"},"reviewedAt":"2026-10-04T15:18:18.136411Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/oliver-kriska/claude-elixir-phoenix/tree/main/.claude/skills/docs-check"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install oliver-kriska-claude-elixir-phoenix@llmmart"},{"target":"git","command":"git clone https://github.com/oliver-kriska/claude-elixir-phoenix.git"}]}