contentrain-doctorlisted
Install: claude install-skill Contentrain/ai
# Skill: Diagnose Project Health with `contentrain doctor`
> Run health checks and turn failures into actionable fixes.
---
## When to Use
Use this when:
- setup seems broken
- generated client may be stale
- Git/content structure may be inconsistent
- the user asks "what is wrong with this project?"
---
## Steps
### 1. Run `contentrain doctor`
Use the CLI health check as the first diagnostic pass.
### 2. Group Findings
Interpret failures by category:
- Git problems
- missing `.contentrain/` structure
- bad config/model parsing
- orphan content
- too many pending branches
- stale SDK client
### 3. Fix in Priority Order
Recommended order:
1. Git / initialization blockers
2. config/model parse failures
3. orphan content or missing paths
4. branch pressure
5. stale generated client
### 4. Apply the Correct Follow-up
- not initialized → `contentrain init`
- stale client → `contentrain generate`
- branch pressure → `contentrain diff`
- invalid content/model state → `contentrain validate`
### 5. Re-run Doctor
After changes, run `contentrain doctor` again to confirm the project is healthy.
## Related Skills
- **contentrain-init** — Re-initialize if project structure is broken
- **contentrain-validate-fix** — Fix content/model validation errors
- **contentrain-generate** — Regenerate SDK if client is stale
- **contentrain** — Core architecture and MCP tool catalog