forge-doctor

Diagnose and fix GSD project issues across milestones and slices.

3|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/vh2224/forge-agent --skill forge-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forge-doctor
Source: https://github.com/vh2224/forge-agent/tree/main/skills/forge-doctor
Command: npx skills add https://github.com/vh2224/forge-agent --skill forge-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and repair health and configuration issues in a GSD project across milestones, slices, and tasks.

Core Features & Use Cases

  • Automated health checks for the GSD project, with structured findings and suggested fixes.
  • Execute fixes with a --fix flag or perform a safe dry-run to preview changes before applying.
  • Integrate with Claude Code workflows to manage state and milestones automatically.

Quick Start

Tell the assistant to run a diagnostic pass on the current project and apply fixes with --fix when ready.

Frequently Asked Questions about forge-doctor

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

FAQPage Schema
How do I diagnose issues in my GSD project?

To diagnose issues in a GSD project, run a diagnostic pass to parse STATE and .gsd configuration, executing automated health checks across milestones and slices to report structured findings.

Can I preview fixes for my GSD project before applying changes?

Yes, you can perform a safe dry-run to preview changes before applying them, ensuring the proposed fixes for your GSD project are reviewed without modifying the actual state.

How do I automatically apply fixes to GSD milestones and slices?

You can automatically apply fixes to GSD milestones and slices by executing the diagnostic command with the --fix flag, which proposes and applies changes in an auditable format.

Does GSD diagnostics work with Claude Code workflows?

Yes, GSD diagnostics integrates with Claude Code workflows to manage state and milestones automatically, running checks and applying repairs within your existing development environment.

What is the best way to audit configuration changes in a GSD project?

The best way to audit configuration changes is using the deterministic diagnostic reporting format, which records findings and applied fixes across your GSD project for full traceability.

Why is my GSD project state not parsing correctly during diagnostics?

State parsing issues occur when the STATE or .gsd configuration files contain errors, which the diagnostic tool detects and reports as structured findings for you to review or fix.