pradeepmouli/speckit-doctor
.agents/skills/speckit-doctor/SKILL.md
Run a full project health diagnostic — checks structure, agents, features, scripts, extensions, and git status.
$ install --global
skillsauthnpx skillsauth add pradeepmouli/rune-langium speckit-doctorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 7:59 AM4.7s1 file scanned
SKILL.md
- name:
- speckit-doctor
- description:
- Run a full project health diagnostic — checks structure, agents, features,
- compatibility:
- Requires spec-kit project structure with .specify/ directory
- author:
- github-spec-kit
- source:
- doctor:commands/check.md
Project Health Check
Run a diagnostic scan of the current Spec Kit project to identify setup issues, missing artifacts, and configuration problems.
User Input
$ARGUMENTS
You MUST consider the user input before proceeding (if not empty).
Outline
-
Run diagnostic script: Execute
.specify/scripts/bash/doctor.shfrom the project root and review the output. -
Analyze results: The script checks 6 areas:
- Project structure —
.specify/,specs/,.specify/scripts/,.specify/templates/,.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
- Project structure —
-
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
-
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.planor/speckit.tasks - Non-executable scripts →
chmod +x .specify/scripts/bash/*.sh - Empty agent commands →
specify init --here --ai <agent>
- Missing directories →
Related Skills
pradeepmouli/rune-langium
tools
VerifiedTrustedCommunity
Router skill for the rune-langium monorepo. Use it to choose the right package skill before working in core, cli, lsp-server, codegen, or visual-editor.
1SKILL.mdUpdated Apr 28, 2026
pradeepmouli/rune-langium
tools
VerifiedTrustedCommunity
Router skill for the rune-langium monorepo. Use it to choose the right package skill before working in core, cli, lsp-server, codegen, or visual-editor.
1SKILL.mdUpdated Apr 20, 2026
pradeepmouli/rune-langium-visual-editor
tools
VerifiedTrustedCommunity
Langium port for Rune DSL tooling Use when working with rune, rosetta, dsl, langium, cdm, isda, drr, finos, language-server, lsp, visual-editor, reactflow.
1SKILL.mdUpdated Apr 20, 2026
pradeepmouli/rune-langium-design-system
tools
VerifiedTrustedCommunity
Langium port for Rune DSL tooling Use when working with rune, rosetta, dsl, langium, cdm, isda, drr, finos, language-server, lsp, visual-editor, reactflow.
1SKILL.mdUpdated Apr 20, 2026