Agent skill · data analytics · yonatangross
doctor
Diagnoses OrchestKit and project health: manifests, hooks, skills, agents, MCP servers, CC version and permissions, with severity and remedies. Use to run doctor checks, diagnose issues or check project health before a release.
Why this skill is useful
Adds specific health diagnostics and validation procedures for OrchestKit that the AI wouldn't reliably generate on its own.
What it needs
Requires bash installed locally. About 11k tokens when loaded. Last updated 2026-08-06. 215 stars on the source repository.
What this skill does
OrchestKit Health Diagnostics Host-neutral workflow. Invoke by skill name (doctor). Claude Code slash routing, YAML hook loaders, and .claude/chain live in references/claude-code.md. Argument Resolution STEP 0: Choose Scope (AskUserQuestion — M118 #1464) A full doctor run takes ~20s. Most invocations only need one slice. Ask the user up-front so voice-flow shortcuts ("just the MCPs") map cleanly: Skip the prompt entirely when the scope is unambiguous from the invocation. The fast scopes (3-8s) are 3-7× faster than the full run — voice users say "just the MCPs" and get a 5s answer. Overview The doctor command performs comprehensive health checks on your OrchestKit installation. It auto-detects installed plugins and validates 16 categories: 1. Installed Plugins - Detects ork plugin 2. Skills Validation - Frontmatter, references, token budget (dynamic count) 3. Agents Validation - Frontmatter, tool refs, skill refs (dynamic count) 4. Hook Health - Registration, bundles, async patterns 5. Permission Rules - Detects unreachable rules 6. Schema Compliance - Validates JSON files against schemas 7. Coordination System - Checks lock health and registry integrity 8. Context Budget - Monitors token usage against budget 9. Memory System - Graph memory health 10. Claude Code Version - Validates CC >= the supportedfloor in shared/cc-support.json (read it; it is the single source). Everything the old "recommends 2.1.154+" note gated (xhigh effort, /ultrareview, stream-json pluginerrors) is floor-guaranteed now, so there is nothing left to recommend 11. External Dependencies - Checks optional tool availability (agent-browser), plus one line per peer skill installed from another marketplace: typesafe@typesafe-ai installed version against the marketplace's, via scripts/check-peer-skill.py (missing marketplace and missing plugin are separate verdicts, the vendor's update commands are the fix text; #4233) 12. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills yonatangross/doctor