gsd-health

Validate `.planning/` directory integrity and optionally repair detected issues.

4|1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/lgwanai/openforce --skill gsd-health-lgwanai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-health
Source: https://github.com/lgwanai/openforce/tree/main/skills/gsd-health
Command: npx skills add https://github.com/lgwanai/openforce --skill gsd-health-lgwanai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly find and resolve integrity problems inside your .planning/ directory so sessions don’t break, degrade, or accumulate orphaned work.

Core Features & Use Cases

  • Planning health validation: Detects missing files, invalid configurations, inconsistent state, and orphaned plans.
  • Optional automated repair: When enabled, repairs detected issues to restore a consistent planning state.
  • Orthogonal context utilization check: Evaluates token usage against the session context window and recommends actions to prevent reasoning quality degradation.

Quick Start

Run openforce /gsd:health --repair to validate and repair your .planning/ directory.

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 or inconsistent state?

To validate planning directory integrity, you can run a health check that parses `.planning/` structure and state to detect missing files, invalid configurations, and orphaned plans, reporting healthy, warning, or critical states.

Can I automatically repair orphaned plans and misconfigured session artifacts?

Yes, you can automatically repair orphaned plans and misconfigured session artifacts by executing the health check with the `--repair` flag to restore a consistent planning state.

How does context utilization validation prevent reasoning quality degradation during a session?

Context utilization validation evaluates token usage against the session context window and recommends actions to prevent reasoning quality degradation, triggered by running the context validation query.

What is the best way to fix a broken planning directory before starting a development workflow?

The best way to fix a broken planning directory is to run a diagnostic validation that identifies missing or inconsistent state and optionally applies automated repairs to ensure session reliability.

Does this planning health check require any external dependencies or SDK components?

No, this planning health check requires no external dependencies or components, running entirely within your existing developer workflow environment to validate directory integrity.