spec-first:doctor

Diagnose project environments and repair missing MCP and skills components.

72|9|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/sunrain520/spec-first --skill spec-first-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-first:doctor
Source: https://github.com/sunrain520/spec-first/tree/main/skills/spec-first/15-doctor
Command: npx skills add https://github.com/sunrain520/spec-first --skill spec-first-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill diagnoses your project environment and host configurations, automatically fixing missing MCP/skills items to ensure a smooth AI development workflow.

Core Features & Use Cases

  • Environment Diagnosis: Checks Node.js, Git, hooks, configurations, and file health.
  • MCP/Skills Health Check: Verifies the presence and configuration of essential AI development tools (MCPs and Skills) for both Codex and Claude Code.
  • Automatic Repair: Attempts to automatically install missing hooks, MCPs, and skills.
  • Use Case: Before starting a new AI development task, run this Skill to ensure your environment is perfectly set up, preventing common setup errors and saving valuable debugging time.

Quick Start

Run the doctor skill to diagnose and repair your current AI development environment.

Frequently Asked Questions about spec-first:doctor

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

FAQPage Schema
How do I diagnose and repair my AI development environment?

To diagnose your AI development environment, run a health check that automatically verifies Node.js, Git, hooks, and file configurations. It then repairs missing MCPs and skills items for Codex and Claude Code, ensuring a smooth setup before you start development tasks.

What does an MCP and skills health check cover for Claude Code and Codex?

An MCP and skills health check verifies the presence and configuration of essential AI development tools for both Codex and Claude Code. It scans your project environment to detect missing hooks, MCPs, and skills components automatically.

Can I automatically install missing hooks and MCPs in my project?

Yes, you can automatically install missing hooks, MCPs, and skills. The diagnostic process detects absent components in your host configurations and attempts automatic installation and repair to prevent common setup errors.

When should I run an environment diagnosis before starting AI development?

You should run an environment diagnosis before starting any new AI development task. This baseline check ensures Node.js, Git, and file health are perfectly configured, preventing common setup errors and saving valuable debugging time.

Does the environment repair tool work without external dependencies?

Yes, the environment repair tool operates without external dependencies. It directly diagnoses your host configurations and project environment, checking baseline Node.js and Git setups to facilitate automatic installation of missing components.