Menu
Run a full project health diagnostic โ checks structure, agents, features, scripts, extensions, and git status.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | speckit-doctor |
| description | Run a full project health diagnostic โ checks structure, agents, features, scripts, extensions, and git status. |
| compatibility | Requires spec-kit project structure with .specify/ directory |
| metadata | {"author":"github-spec-kit","source":"doctor:commands/check.md"} |
Run a diagnostic scan of the current Spec Kit project to identify setup issues, missing artifacts, and configuration problems.
$ARGUMENTS
You MUST consider the user input before proceeding (if not empty).
Run diagnostic script: Execute .specify/extensions/doctor/scripts/bash/doctor.sh from the project root and review the output.
Analyze results: The script checks 6 areas:
.specify/, specs/, .specify/scripts/, .specify/templates/, .specify/memory/, .specify/memory/constitution.mdspecs/, checks for spec.md/plan.md/tasks.mdReport findings: Present the diagnostic results to the user:
Suggest fixes: For each error or warning found, suggest the specific command or action needed to resolve it. Common fixes include:
specify init --here.specify/templates/constitution-template.md/speckit.plan or /speckit.taskschmod +x .specify/scripts/bash/*.shspecify init --here --ai <agent>Interact with Paddock โ AI agent orchestration dashboard. Use when registering agents, managing tasks, syncing skills, or querying agent/task status via Paddock APIs.
Convert existing tasks into actionable, dependency-ordered GitHub issues for the feature based on available design artifacts.
Claude AskUserQuestion rendering for speckit checklist.
Claude AskUserQuestion rendering for speckit clarify.
Create or update the feature specification from a natural language feature description.
Perform a non-destructive post-implementation verification gate validating the implementation against spec.md, plan.md, tasks.md, and constitution.md.