doctor
Skill9 starsChanged 3 months agoMITView on GitHub
Validate framework configuration, check runtime dependencies, and report issues. Use when something isn't working or after setup.
- Reads credentials
85 other projects use a version of this.
Adopted by
Most recently taken up by
- aaroncohn/babysittertheir own version, first seen Nov 16, 2026
- Yomudogly/oh-my-agytheir own version, first seen Nov 16, 2026
- timursafiullin/aodtheir own version, first seen Nov 15, 2026
- mkritter3/codex-paired-superpowerstheir own version, first seen Nov 15, 2026
- dcamunas/model-routertheir own version, first seen Nov 15, 2026
- Noah-OS/longhaultheir own version, first seen Nov 15, 2026
Used with
Projects with it also use cancel, hud and 9 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
woosikkimSkillcancel
Clear any stale OMC-Slim state
Also in 4 projects that use this
ibahgatSkillhud
Control omi visual HUD profile and keep status output readable in normal, compact, or hidden mode.
Also in 3 projects that use this
ibahgatSkillralplan
Create a strict, quality-first execution plan with explicit gates and rollback-ready sequencing.
Also in 3 projects that use this
QinghongLinSkilleditor
Read analyst.json and detective.json, make all editorial decisions — what the blog argues, which findings matter, narrative arc and section structure. No visual design. Outputs editor.md (prose) and editor.json (structure with edt_xx IDs).
Also in 3 projects that use this
BlockSkillopen
Open markdown documents in Penpal for collaborative review. Use when you want a human to review a document, plan, or research artifact.
Also in 3 projects that use this
Arman-KudaibergenovSkillinspect
Этот скилл MUST быть вызван для анализа и инспекции любого объекта 1С из XML-выгрузки: конфигурация (cf-info), объект метаданных (meta-info), управляемая форма (form-info), схема компоновки данных СКД (skd-info), макет табличного документа MXL (mxl-info), подсистема (subsystem-info), роль и права (role-info). SHOULD вызывать как подготовительный шаг перед любой модификацией объекта. Do NOT использовать для модификации — для изменений используй соответствующие edit/compile скиллы.
Also in 3 projects that use this
- +1 more from ibahgat
Other versions85 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 85
- Yeachan-Heo/oh-my-codex★ 34ksame name
- jihe520/MathModelAgent★ 6.2ksame name
- spotify/portal-ai-plugins★ 2.8ksame name
- fakechris/obsidian_vault_pipeline★ 173same name
- NoobyGains/godmode★ 120same name
- Rich627/whatsapp-claude-plugin★ 114same name
- bluzir/claude-code-design★ 102same name
- jjanczur/tyran★ 79same name
- svy04/ballast★ 73same name
- Hainrixz/agente-pagokit★ 68same name
75 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository56 other files it gives its agents.
- .claude/agents/CLAUDE.mdCLAUDE.md
- .claude/hooks/CLAUDE.mdCLAUDE.md
- CLAUDE.mdCLAUDE.md
- .claude/prompts/CLAUDE.mdCLAUDE.md
- .claude/rules/CLAUDE.mdCLAUDE.md
- .claude/skills/CLAUDE.mdCLAUDE.md
- docs/CLAUDE.mdCLAUDE.md
- vision/CLAUDE.mdCLAUDE.md
- llms.txtllms.txt
- scaffold/llms.txtllms.txt
- architecture-checkSkill
- backlog-reviewSkill
- bootstrapSkill
- brainstormSkill
- buildSkill
- claude-sense-checkSkill
- code-qualitySkill
- commitSkill
- continueSkill
- custom-hooksSkill
- dashboardSkill
- debug-sessionSkill
- deploySkill
- discoverSkill
- fix-issueSkill
- framework-upgradeSkill
- handoffSkill
- help-meSkill
- ideateSkill
- lanesSkill
- manual-testSkill
- merge-downSkill
- merge-upSkill
- optimizeSkill
- parallel-workSkill
- performance-checkSkill
- phase-reviewSkill
- pr-statusSkill
- quality-checkSkill
- quickstartSkill
- refine-loopSkill
- researchSkill
- retrospectiveSkill
- security-auditSkill
- skill-createSkill
- skill-evalSkill
- sprint-endSkill
- sprint-startSkill
- story-cycleSkill
- testing-cycleSkill
- test-validatorSkill
- UAT-cycleSkill
- undo-workSkill
- uninstallSkill
- weekly-maintenanceSkill
- wrap-upSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
14 rules. 0 are common, 6 are distinctive, and 8 are very specific to this project.
0
Common
Most of the 64 edited versions we read keep these.
6
Distinctive
This author's own choices. Worth a look.
8
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 16
Run a comprehensive health check on the framework configuration and project setup.
- Distinctive: line 20
Read CLAUDE.md Commands section.
- Very specific: line 23
Run the command in dry-run or check mode (e.g., npm test --dry-run, ruff check --quiet .).
- Distinctive: line 34
Verify the hook script file exists and is executable
- Very specific: line 45
Read the YAML frontmatter paths: field
- Distinctive: line 46
Check if any files in the project match those patterns
- Very specific: line 48
Check docs/sessions/.activity-log.jsonl for rule trigger frequency over the last 5 sessions
- Very specific: line 56
Verify each dependency skill exists in .claude/skills/
- Very specific: line 62
Verify each called skill exists in .claude/skills/
- Distinctive: line 68
Check key framework files:
- Very specific: line 136
Verify lib/hook-guard.sh exists and is executable
- Very specific: line 141
If docs/reference/READINESS_REPORT.md exists, compare the bootstrap baseline against current project state:
- Distinctive: line 143
Read and parse the readiness assessment table (Principle / Status / Detail)
- Very specific: line 160
If the file does not exist, report: "No readiness baseline — run /bootstrap to generate docs/reference/READINESS_REPORT.md."
“Common” is measured: kept by at least 6 in 10 of the 64 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
doctor
Run a comprehensive health check on the framework configuration and project setup.
1. Command Verification
Read CLAUDE.md Commands section. For each configured command (test, lint, format, build, typecheck):
<IF condition="command is configured (not placeholder)">
Run the command in dry-run or check mode (e.g., `npm test --dry-run`, `ruff check --quiet .`).
Report: PASS if it executes, FAIL if it errors, SKIP if not configured.
</IF>
<ELSE>
Report: NOT CONFIGURED — suggest running `/bootstrap` to detect.
</ELSE>2. Hook Dependencies
For each hook in .claude/settings.json:
- Verify the hook script file exists and is executable
- For
post-edit-format.sh: check if at least one formatter is installed (prettier, biome, ruff, black, rustfmt, gofmt) - For shell hook scripts: verify git is available (used by stop.sh, session-start.sh)
- Optional: check if jq is available (hooks fall back to sed without it)
Report: PASS/WARN (missing optional tools)/FAIL (missing required tools)
3. Rule Relevance
For each rule in .claude/rules/:
- Read the YAML frontmatter
paths:field - Check if any files in the project match those patterns
- Report: ACTIVE (matches found) / DORMANT (no matches — rule will never trigger)
- Check
docs/sessions/.activity-log.jsonlfor rule trigger frequency over the last 5 sessions - Rules that are ACTIVE but have zero trigger events in 5+ sessions: report as REVIEW (candidate for retirement)
- The "pull their weight" test: if a rule never changes AI behavior, it wastes context budget
4. Skill Dependencies & Cross-References
For each skill with depends-on: in YAML frontmatter:
- Verify each dependency skill exists in
.claude/skills/ - For skills with
requires:— check binaries, commands, and files - Report: PASS/WARN (optional dependency missing)/FAIL (required dependency missing)
For each skill with calls: in skills-registry.json:
- Verify each called skill exists in
.claude/skills/ - Report any broken references (skill calls a non-existent skill)
- Report orphaned skills (not called by any other skill AND not user-invocable) as INFO — may be intentionally standalone
5. Documentation Freshness
Check key framework files:
- CLAUDE.md: Is "Current Focus" section filled (not placeholder)?
- docs/progress.md: Has it been updated this sprint?
- docs/reference/BACKLOG_INDEX.md: Are status counts current?
- docs/reference/GROUND_RULES.md: Does it exist and have principles?
Report: CURRENT/STALE/MISSING for each
6. Git State
- Branch naming follows convention (
feat/*,fix/*,hotfix/*,refactor/*,docs/*,test/*,chore/*, orsprint-*)? - Any stale branches (merged but not deleted)?
- Any unmerged branches with no commits in the last 2 weeks?
Flag branches with no commits in >14 days as "potentially stale — consider merging or deleting"git for-each-ref --sort=-committerdate --format='%(refname:short) %(committerdate:relative)' refs/heads/ | while read branch date; do echo "$branch — last commit $date"; done - Remote configured and accessible?
7. Skill Conformance
Execute scripts/validate-skills.sh directly — do NOT read source first.
bash .claude/skills/doctor/scripts/validate-skills.shReports per-skill conformance: YAML frontmatter, line budget, required sections, reference budgets, registry version match. Include results in the health report under a "Skill Conformance" section.
8. Skill Usage Analytics
Parse docs/sessions/.activity-log.jsonl for entries with "type":"skill":
# Extract skill invocation data from activity log
grep '"type":"skill"' docs/sessions/.activity-log.jsonl 2>/dev/null || echo "No skill data"- Count invocations per skill name over all available log data
- Find the most recent invocation timestamp per skill
- List all skill directories from
.claude/skills/(excluding SKILLS_INVENTORY.md, SKILL_TEMPLATE.md, and non-directory entries) - Cross-reference invocations with available skills to classify:
- ACTIVE: Invoked at least once in the log
- DORMANT: Skill directory exists, user-invocable, but never invoked
- FREQUENT: Invoked 5+ times (top skills)
- Note: Skills not in the log may still be useful — they may not have been needed yet. DORMANT is informational, not a problem.
9. Profile & Hook Status
Report the current project profile and hook configuration:
echo "Project profile: $(cat .claude/hooks/state/project-profile 2>/dev/null || echo 'standard (default)')"
echo "EXOSUIT_PROJECT_PROFILE=${EXOSUIT_PROJECT_PROFILE:-<not set, reading from CLAUDE.md>}"
echo "EXOSUIT_HOOK_PROFILE=${EXOSUIT_HOOK_PROFILE:-<derived from project profile>}"
echo "EXOSUIT_DISABLED_HOOKS=${EXOSUIT_DISABLED_HOOKS:-<none>}"
echo "EXOSUIT_EXPLAIN_MODE=${EXOSUIT_EXPLAIN_MODE:-brief}"
echo "EXOSUIT_STOP_MAX_ITERATIONS=${EXOSUIT_STOP_MAX_ITERATIONS:-5}"- Show current project profile and its source (env var, CLAUDE.md
**Profile:**line, or default) - Show derived hook profile and whether it was explicitly overridden
- Profile implications:
- lean: minimal hooks, simplified story-cycle (Plan→Build→Verify), no quality agents, no sprint specs
- standard: standard hooks, full 8-phase story-cycle, 3 quality agents, full docs
- strict: strict hooks, all phases mandatory for all stories, 5 quality agents + integration-tester, audit trail
- List any disabled hooks
- Verify
lib/hook-guard.shexists and is executable - Show effective stop iteration limit (strict defaults to 10)
10. Readiness Progress
If docs/reference/READINESS_REPORT.md exists, compare the bootstrap baseline against current project state:
- Read and parse the readiness assessment table (Principle / Status / Detail)
- For each principle classified as
⚠️ Riskor✗ Missing, re-evaluate using data from sections 1–9:- TDD-first → Test command (§1) + run coverage tool if available
- Sprint-based / Git-disciplined → Git state (§6)
- Verification-driven → Test command passes (§1)
- CI-enforced → Check for
.github/workflows/,.gitlab-ci.yml,.circleci/,Jenkinsfile - Secrets-aware → Post-edit hook (§2) +
.env*in.gitignore - Anti-slop →
code-slop.mdrule exists (§3) - Quality gates → Formatter + linter + coverage + typecheck all available (§1)
- Context-efficient → Source files >500 LOC:
find . -name '*.{ext}' -not -path '*/node_modules/*' | xargs wc -l | awk '$1>500 && !/total$/' | wc -l - Documentation-lean → Core docs populated (§5)
- Pre-commit hooks →
.pre-commit-config.yaml,.husky/, orlefthook.ymlexists - Type-safe → Typecheck command works (§1)
- Contract-first / API-documented → API spec files +
API_DOCUMENTATION.md(skip if no API detected) - Decisions-documented →
docs/adr/has ≥1 accepted ADR
- Classify each as
✓ Ready,⚠️ Risk, or✗ Missingusing bootstrap's classification rules
If the file does not exist, report: "No readiness baseline — run /bootstrap to generate docs/reference/READINESS_REPORT.md."
Output
## Framework Health Report
### Commands
| Command | Status | Notes |
|---------|--------|-------|
| test | PASS/FAIL/NOT CONFIGURED | [details] |
| lint | PASS/FAIL/NOT CONFIGURED | [details] |
| ... | | |
### Hooks
| Hook | Status | Missing Tools |
|------|--------|---------------|
| post-edit-format.sh | PASS/WARN | [list] |
| ... | | |
### Rules
| Rule | Status | Matching Files |
|------|--------|----------------|
| testing.md | ACTIVE | [count] files |
| ... | | |
### Skills
| Check | Status | Details |
|-------|--------|---------|
| Dependency resolution | PASS/WARN | [details] |
| Prerequisites | PASS/WARN | [details] |
### Documentation
| File | Status | Last Updated |
|------|--------|-------------|
| CLAUDE.md | CURRENT/STALE | [date] |
| ... | | |
### Skill Conformance
| Skill | Frontmatter | Lines | References | Registry |
|-------|-------------|-------|------------|----------|
| [name] | PASS/FAIL | [count] | PASS/WARN | PASS/WARN |
### Skill Usage
| Skill | Invocations | Last Used | Status |
|-------|-------------|-----------|--------|
| story-cycle | 15 | 2026-03-25 | ACTIVE |
| manual-test | 0 | never | DORMANT |
### Profile & Hook Configuration
| Setting | Value | Source |
|---------|-------|--------|
| Project Profile | lean/standard/strict | env var / CLAUDE.md / default |
| Hook Profile | minimal/standard/strict | env var / derived from project |
| Disabled Hooks | none or list | EXOSUIT_DISABLED_HOOKS |
| Explain Mode | off/brief/verbose | EXOSUIT_EXPLAIN_MODE |
| Stop Iterations | 5/10/custom | EXOSUIT_STOP_MAX_ITERATIONS |
| Guard script | PASS/FAIL | lib/hook-guard.sh |
### Readiness Progress (if baseline exists)
| Principle | Bootstrap | Current | Progress |
|-----------|-----------|---------|----------|
| TDD-first | ✗ Missing | ✓ Ready | ↑ Fixed |
| CI-enforced | ⚠️ Risk | ⚠️ Risk | → Unchanged |
**Progress:** X of Y gaps addressed since bootstrap ({date})
_Only rows for principles that were Risk or Missing at bootstrap. Omit Ready principles._
### Overall: X/Y checks passed — [HEALTHY / NEEDS ATTENTION / ACTION REQUIRED]Next Steps
Based on findings, suggest:
/bootstrap— if commands or hooks need configuration- Specific fixes for any FAIL items
/weekly-maintenance— if documentation is stale- Foundation stories from
E00-foundation.md— if readiness gaps persist
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

