skills.rest
LeroyAdonis
LeroyAdonisCOMMUNITY
Explore all skills by this author →
GitHub

doctor

Diagnoses Blueprint project setup health and outputs an ordered repair plan.

Updated Mar 2, 2026
Search Tags:#git#workflow#project setup#health check#diagnostics#blueprint#read-only
One-click install
npx skills add https://github.com/LeroyAdonis/kitfix-2.0 --skill doctor-leroyadonis
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/LeroyAdonis/kitfix-2.0/tree/main/.agents/skills/doctor
Command: npx skills add https://github.com/LeroyAdonis/kitfix-2.0 --skill doctor-leroyadonis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Blueprint-based projects can silently drift: missing files, incomplete onboarding, placeholder plans, stale overviews, or workflow state that no longer matches git. This Skill runs a read-only diagnostic pass that tells you whether the project is healthy and exactly what to fix first. ## Core Features & Use Cases - Read-only health check: Inspects required Blueprint files, tool adapters, commands, ignore rules, plans, workflow state, and git without editing, committing, or building anything. - Ordered repair plan: Ends every report with a prioritized Repair order, from restoring missing files to running /onboard, /overview, /implement, or /complete. - Adapter and visibility awareness: Validates Codex, Claude Code, GitHub Copilot, and OpenCode skill trees, plus local-only .gitignore visibility modes. - Use Case: Before resuming work on a Blueprint project, run /doctor to confirm onboarding finished, plans are filled in, the overview is fresh, and no P0/P1 findings block completion. ## Quick Start Ask the assistant to run a Blueprint health check with /doctor and report whether the project setup is ready for the next feature.

Frequently Asked Questions about doctor

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

FAQPage Schema
How do I check if my Blueprint project setup is healthy?▼

Run /doctor with no arguments. It performs a read-only scan of required Blueprint files, adapters, commands, plans, workflow state, and git, then prints a Health verdict of Pass, Needs attention, or Blocked with an ordered repair plan.

What is the difference between /doctor and /status in Blueprint?▼

Use /status when you want progress and the next build action. Use /doctor when you want to know whether the workflow itself is healthy, such as after setup drift, incomplete onboarding, or when something feels off before starting work.

Does the doctor skill modify files or run builds?▼

No. The doctor skill is strictly read-only. It never writes files, commits, installs dependencies, runs builds or tests, or switches branches. It only diagnoses issues and suggests the exact repair commands to run yourself.

Which AI coding tools does the Blueprint doctor check support?▼

It validates adapters for Codex, Claude Code, GitHub Copilot, and OpenCode by reading blueprint/.state/manifest.json and checking .agents/skills/ or .claude/skills/ trees. Extra adapters are reported as optional clutter, not failures.

Why does the doctor report my project overview as stale?▼

The overview is flagged stale when blueprint/project-plan.md or blueprint/build-plan.md has a newer filesystem timestamp than blueprint/context/project-overview.md. Run /overview to regenerate it before starting feature work.

Related Skills

Explore More Software Engineering Skills→
rickardprickardp
2

blueprint:onboard

Generate a Blueprint onboarding structure from an existing repository, including ADRs and agent instructions.

Community
Advanced
SollanSystemsSollanSystems
1

loop-engineer

Routes agent-loop objectives into design, contract, run, repair, eval, or flywheel workflows.

Community
Advanced
mjamoremjamore

repo-docs-audit

Audit repository documentation against code and active plans to surface drift.

Community
Intermediate
kamalsroor1kamalsroor1

speckit-git-initialize

Initialize a Git repository with an initial commit when none exists.

Community
Intermediate