FlaviusBurghila/claude-agent-kit / skills/doctor
doctor
VerifiedCheck that agent-kit is set up correctly in this project and on this machine — hooks, agents, model aliases, the Agent contract and conflicts with a script install. Read-only.
Check the agent-kit setup and report what is wrong. Read-only: change nothing; for each problem, give the fix and let the user apply it.
Run the independent checks together, then report one line per check: OK, WARN or FAIL,
what you saw, and for anything but OK the fix.
- Node.js —
node --versionis 18 or later. Both hooks need it; without it the read budget and the orchestration rules silently do nothing. - Hooks run — pipe
{}intonode "${CLAUDE_PLUGIN_ROOT}/agent-kit/hooks/session-start.js": it must print JSON withadditionalContext, or print nothing only when check 4 finds a script install. Then run it withAGENT_KIT_ENGAGE_TOKENS=0(full rules,# Orchestration rules) and pipe{}intoengage.js(prints nothing: nosession_id, so quiet). - Claude Code version —
claude --version: 2.1.293 or later letshaikumean Haiku 5.5 on the Anthropic API; under 2.1.246,maxTurnspartial results are missing. - Script install alongside the plugin — look for
builder.mdin~/.claude/agents/and<repo>/.claude/agents/, and for the<!-- claude-agent-kit:begin -->marker in~/.claude/CLAUDE.md,<repo>/CLAUDE.mdand<repo>/.claude/CLAUDE.md. Either means a script install: WARN, since each agent then exists twice (builderandagent-kit:builder) and the read-budget hook runs twice. Fix:install.sh --uninstall --globalor--project. - Model pins — read
envin~/.claude/settings.json,<repo>/.claude/settings.jsonand<repo>/.claude/settings.local.json.CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1flattens the kit's model tiers: WARN.ANTHROPIC_DEFAULT_{HAIKU,SONNET,OPUS}_MODELpins an alias for the whole session: report the value. - Explore — if
permissions.denydoes not containAgent(Explore), report it as INFO only: the built-in Explore runs on the main session's model; denying it is optional. - Agent contract — the project's CLAUDE.md (or
.claude/CLAUDE.md) has a## Agent contractsection with a Verify line that is not a<placeholder>. If not: FAIL, fix:/agent-kit:init. - Read threshold — if
SHUNT_MIN_LINESis set, the contract's "Read threshold" line names the same number.SHUNT_OFF=1anywhere: WARN, the read budget is off. - Scratch space — in a git work tree,
git check-ignore -q .claude/tmp/xsucceeds. If not: WARN, fix: add.claude/tmp/to.gitignore.
End with the count of OK / WARN / FAIL and the fixes in the order to apply them.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 468k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |