gsd-health

Diagnose .planning directory health issues and validate workflow integrity.

264|11|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/coco-research/coco --skill gsd-health-coco-research
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-health
Source: https://github.com/coco-research/coco/tree/main/systems/gsd/skills/gsd-health
Command: npx skills add https://github.com/coco-research/coco --skill gsd-health-coco-research

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It checks the health of a .planning directory so you can quickly spot missing files, invalid configuration, inconsistent state, and orphaned plans before they disrupt your workflow.

Core Features & Use Cases

  • Directory integrity validation: Confirms the planning workspace is complete and structurally sound.
  • Issue reporting: Surfaces actionable problems such as missing entries, broken configuration, and stale or orphaned plan state.
  • Optional repair flow: Supports a repair pass when you want the skill to fix correctable issues instead of only reporting them.

Quick Start

Ask the assistant to inspect the .planning directory for health issues and repair any fixable problems if needed.

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 for missing files and inconsistent state?

Planning directory validation checks your .planning workspace to detect missing files, invalid configurations, inconsistent state, and orphaned plans before they disrupt your workflow.

What does .planning directory health diagnostics include?

Directory health diagnostics confirms structural soundness and surfaces actionable problems such as missing entries, broken configuration, and stale or orphaned plan state.

Can I repair orphaned plans and invalid configurations automatically?

Yes, you can repair orphaned plans and invalid configurations by passing the optional --repair flag, which fixes correctable issues instead of only reporting them.

What is the best way to fix broken planning workspace configuration?

The best way to fix broken planning workspace configuration is to run health diagnostics with the repair flag, which applies correctable fixes to invalid configurations and inconsistent state.

Do I need an external health workflow to run planning directory validation?

Yes, planning directory validation requires the external health workflow to execute, while the skill itself diagnoses issues and optionally passes repair intent through that workflow.