# Speckit Doctor Check

> Run a full project health diagnostic — checks structure, agents, features, scripts, extensions, and git status.

- Skill: `racecraft-lab/speckit-doctor-check` (Agent Skill)
- Install (CLI): `npx skillmds add racecraft-lab/speckit-doctor-check`
- Raw SKILL.md: https://api.skillmd.com/api/skills/racecraft-lab/speckit-doctor-check/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: racecraft-lab (https://skillmd.com/u/racecraft-lab)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/racecraft-lab/speckit-doctor-check

---


# Project Health Check

Run a diagnostic scan of the current Spec Kit project to identify setup issues, missing artifacts, and configuration problems.

## User Input

```text
$ARGUMENTS
```

You **MUST** consider the user input before proceeding (if not empty).

## Outline

1. **Run diagnostic script**: Execute `.specify/extensions/doctor/scripts/bash/doctor.sh` from the project root and review the output.

2. **Analyze results**: The script checks 6 areas:
   - **Project structure** — `.specify/`, `specs/`, `.specify/scripts/`, `.specify/templates/`, `.specify/memory/`, `.specify/memory/constitution.md`
   - **AI agent configuration** — detects which agent folder is present, verifies commands exist
   - **Feature specifications** — lists features in `specs/`, checks for spec.md/plan.md/tasks.md
   - **Scripts health** — verifies all bash and PowerShell scripts are present and executable
   - **Extensions health** — validates extensions.yml and extension registry
   - **Git status** — checks if inside a git repo, shows current branch

3. **Report findings**: Present the diagnostic results to the user:
   - **Errors** — things that are broken and need fixing
   - **Warnings** — things that could cause problems
   - **Notes** — informational items about the project state

4. **Suggest fixes**: For each error or warning found, suggest the specific command or action needed to resolve it. Common fixes include:
   - Missing directories → `specify init --here`
   - Missing constitution → copy from `.specify/templates/constitution-template.md`
   - Missing feature artifacts → run `/speckit.plan` or `/speckit.tasks`
   - Non-executable scripts → `chmod +x .specify/scripts/bash/*.sh`
   - Empty agent commands → `specify init --here --ai <agent>`