gsd-health

Diagnose planning directory health and report actionable issues.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/Poom5741/eggo-world-pb --skill gsd-health-poom5741
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-health
Source: https://github.com/Poom5741/eggo-world-pb/tree/main/.qwen/skills/gsd-health
Command: npx skills add https://github.com/Poom5741/eggo-world-pb --skill gsd-health-poom5741

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose planning directory health and report actionable issues. Checks for missing files, invalid configurations, inconsistent state, and orphaned plans.

Core Features & Use Cases

  • Validate the integrity of the .planning/ directory and surface actionable issues.
  • Offer optional repair paths when --repair is provided to fix common misconfigurations.
  • Provide guidance for remediation and future preventive checks.

Quick Start

Run the gsd-health skill to validate your .planning directory and apply repairs when requested.

Frequently Asked Questions about gsd-health

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

FAQPage Schema
How do I validate my planning directory and fix inconsistent workflow states?

To validate planning directory health, run a diagnostic check that surfaces missing files, invalid configurations, and orphaned plans, then apply the --repair flag to automatically fix common misconfigurations.

What causes orphaned plans and invalid configurations in a workflow repository?

Orphaned plans and invalid configurations occur when workflow repository files are manually deleted or states diverge from expected planning directory structures, requiring integrity checks to identify and resolve these mismatches.

How do I automate a health check for my planning directory to prevent workflow issues?

Automate a planning directory health check by running validation commands that enforce file integrity, verify configurations, and report actionable issues to prevent future workflow inconsistencies.

Can I repair orphaned plans and missing files without manual intervention?

Yes, you can repair orphaned plans and missing files automatically by executing the health-check with the --repair flag, which fixes common misconfigurations and restores missing files in the planning directory.

Does the planning directory validation tool require any external dependencies?

No, the planning directory validation tool operates without external dependencies, directly diagnosing the .planning directory structure and reporting actionable issues independently.

What are the limitations of automated repair for workflow planning directories?

The automated repair for workflow planning directories is limited to fixing common misconfigurations and missing files, providing guidance for remediation rather than resolving complex inconsistent state issues.