doctorlisted
Install: claude install-skill fjpulidop/specrails-core
# SpecRails Doctor
Run a full diagnostic check on the sr plugin installation and project configuration. Outputs a health report that identifies missing components, misconfigured files, and actionable fixes.
**Input:** $ARGUMENTS — optional:
- `--fix` — automatically fix issues where possible (safe fixes only: create missing dirs, initialize empty config files)
- `--verbose` — show detailed output for each check
---
## Check 1: Plugin agents
Verify that all expected plugin agents are accessible. The sr plugin should provide 14 agents:
Expected agents: `sr:architect`, `sr:developer`, `sr:reviewer`, `sr:backend-developer`, `sr:frontend-developer`, `sr:backend-reviewer`, `sr:frontend-reviewer`, `sr:security-reviewer`, `sr:performance-reviewer`, `sr:test-writer`, `sr:doc-sync`, `sr:merge-resolver`, `sr:product-manager`, `sr:product-analyst`
Check: Read the plugin's agent definitions to confirm they're installed.
Result: `PASS` if all agents found, `WARN` if some missing.
---
## Check 2: Required tools
Check for required CLI tools:
```bash
which git && git --version
which openspec && openspec --version 2>/dev/null || echo "MISSING"
which gh && gh --version 2>/dev/null || echo "NOT_INSTALLED (optional)"
which npm && npm --version 2>/dev/null || echo "NOT_INSTALLED (optional)"
```
- `git` — required
- `openspec` — required for OpenSpec workflow (`/specrails:opsx:*` skills)
- `gh` — required only if `BACKLOG_PROVIDER=github`
- `npm` — required only if project uses Node.js