speckit-doctor-check

Run a full health diagnostic of a Spec Kit project to detect setup and configuration issues.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-doctor-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-doctor-check
Source: https://github.com/B0yZ4kr14/OrthoPlus-Enterprise/tree/main/.specify-backups/20260518-141826/_agents/skills/speckit-doctor-check
Command: npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-doctor-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly identify why a Spec Kit project setup is broken or incomplete by running a structured health diagnostic and turning the results into actionable fixes.

Core Features & Use Cases

  • Project structure validation: Confirms required Spec Kit directories and key files exist to ensure the project can run and be extended safely.
  • Agent configuration checks: Detects which agent is present and verifies that expected commands and wiring exist for the agent workflow.
  • Feature, script, extension, and git status audits: Checks feature artifacts under specs, verifies script presence/executability, validates extension configuration, and reports whether the workspace is in a git repository with the current branch.

Quick Start

Run the speckit-doctor-check skill in your Spec Kit project root to scan for missing artifacts and configuration issues, then review the reported errors, warnings, and suggested commands.

Frequently Asked Questions about speckit-doctor-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose a broken Spec Kit project setup?

A Spec Kit health check validates required directories, agent wiring, feature artifacts, script executability, and git status to identify missing artifacts and configuration problems causing initialization failures.

How do I verify Spec Kit agent configuration and feature readiness?

Spec Kit agent configuration checks detect which agent is present and verify expected commands and wiring exist, while feature audits check artifacts under the specs directory to confirm overall feature readiness.

Can I check git status and script integrity within a Spec Kit project?

Yes, you can check git status and script integrity within a Spec Kit project by running a health diagnostic that reports the current git branch and validates script presence and executability across the workspace.

Why is my Spec Kit initialization missing required project artifacts?

Spec Kit initialization fails when required directories or key files are missing, causing setup issues that a project structure validation diagnostic can detect and report as actionable errors.

What is the best way to troubleshoot Spec Kit extension configuration problems?

The best way to troubleshoot Spec Kit extension configuration problems is to run a health diagnostic that validates extension settings and reports actionable warnings and suggested commands for fixes.

Does the Spec Kit health diagnostic require any dependencies to run?

No, the Spec Kit health diagnostic requires no external dependencies to run, as it executes the project doctor script directly across the workspace structure and configuration files.