Skip to content

tonone-ai/tonone / bundle/engineering-team/skills/tonone-doctor

tonone-doctor

Verified

Read-only health report for tonone state — corrupt .tonone/ files, hook wiring, drift between skills, mirror, bundles and index. Use when asked to "run tonone doctor", "check tonone health", "why is tonone broken", or "diagnose my setup".

tonone-doctor

Cross-agent health check. Not tied to a single agent. Read-only: it reports and suggests, it never fixes.

Follow the output format defined in docs/output-kit.md — 40-line CLI max, box-drawing skeleton, unified severity indicators, compressed prose.

Steps

Step 1: Run the doctor

CLAUDE_PLUGIN_ROOT is not always exported into the Bash tool, so locate the script first:

doc=""
for c in "${CLAUDE_PLUGIN_ROOT:-/nonexistent}/scripts/tonone-doctor.py" \
         "${CLAUDE_PLUGIN_ROOT:-/nonexistent}/../../scripts/tonone-doctor.py" \
         "$PWD/scripts/tonone-doctor.py"; do
  [ -f "$c" ] && doc="$c" && break
done
[ -z "$doc" ] && doc=$(find "$HOME/.claude/plugins/cache" -maxdepth 6 -path "*/scripts/tonone-doctor.py" 2>/dev/null | head -1)
python3 "$doc" --json

Scope is auto-detected from the working directory: a user project (.tonone/ files, DESIGN.md/PRODUCT.md, hooks, opt-in hook state) or the tonone plugin repo (also runs the gen-skill-docs, sync-skills, sync-bundles checks, skill-index staleness, headline counts). Use --root DIR to point elsewhere. Use the box output (drop --json) for a quick look. --usage [--since 7d] summarizes the opt-in .tonone/metrics.jsonl counters (enable with TONONE_METRICS=on).

Step 2: Interpret

Group findings by severity. For each WARNING or CRITICAL, give the cause in one line and the fixing command:

FindingSuggested fix
.tonone/*.json fails to parseOpen the file, fix the JSON, or delete it if it is regenerable
Path in .tonone/ file is missingUpdate or remove the entry
Hook registered but script missingRestore the script or remove the hook entry
gen-skill-docs driftpython scripts/gen-skill-docs.py
sync-skills driftpython scripts/sync-skills.py
sync-bundles driftpython scripts/sync-bundles.py
skill-index stalepython scripts/gen-skill-index.py
Headline counts mismatchUpdate totals in README/CLAUDE.md/manifests

INFO lines (token drift hint, stale files, opt-in hook state) are awareness only.

Step 3: Report

Box header TONONE ── doctor, one-line verdict, top findings with ■ CRITICAL / ▲ WARNING / ● INFO, then the fix commands as next steps. Do not run any fix yourself; the user decides. CI use: --strict exits 1 on any WARNING or CRITICAL.

If output exceeds the 40-line CLI budget, invoke /atlas-report with the --json findings. CLI is the receipt: box header, verdict, top 3 findings, report path.

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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall