skills.rest
roycolumbia-code
roycolumbia-codeCOMMUNITY
Explore all skills by this author →
GitHub

gsd-health

Check .planning/ directory health and repair issues in GSD workflows.

Updated Mar 23, 2026
Search Tags:#context analysis#system maintenance#directory health#repair actions#planning integrity
One-click install
npx skills add https://github.com/roycolumbia-code/claude-global-config --skill gsd-health-roycolumbia-code
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-health
Source: https://github.com/roycolumbia-code/claude-global-config/tree/main/skills/_audit-disabled-20260706-1136/gsd-health
Command: npx skills add https://github.com/roycolumbia-code/claude-global-config --skill gsd-health-roycolumbia-code

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

gsd-health is a tool for maintaining the integrity of the .planning/ directory, identifying issues, and offering repair options, which is crucial for effective workflow management and system health.

Core Features & Use Cases

  • Directory Integrity Check: Validates the .planning/ directory for missing files, invalid configurations, and inconsistent states.
  • Context Utilization: Assesses the running session's context usage to provide feedback on token and context window limits.
  • Repair Issues: Offers repair actions to fix identified problems when the --repair flag is used.
  • Use Case: Running gsd-health --repair could resolve inconsistencies that affect the workflow of planning tasks, potentially improving the efficiency and accuracy of the workflow.

Quick Start

Run the gsd-health skill to diagnose and optionally repair health issues in your .planning/ directory by executing 'gsd-health'.

Frequently Asked Questions about gsd-health

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

FAQPage Schema
How do I check planning directory integrity in GSD workflows?▼

To check planning directory integrity, run the gsd-health skill to validate the `.planning/` directory for missing files, invalid configurations, and inconsistent states.

What causes context window performance issues during task planning?▼

Context window performance issues arise from high context utilization. The health check assesses the running session's context usage to predict token limit impacts on workflow stability.

How do I repair invalid configurations in a .planning directory?▼

To repair invalid configurations in a `.planning/` directory, execute the command with the `--repair` flag to automatically apply repair actions to identified inconsistencies.

Can I use gsd-health to fix inconsistent states without losing planning data?▼

Yes, you can use gsd-health to fix inconsistent states. Running `gsd-health --repair` resolves directory issues and improves workflow efficiency while maintaining your planning task data.

When should I run a directory health check for system maintenance?▼

You should run a directory health check for system maintenance when you notice workflow instability or before critical planning tasks to ensure the `.planning/` directory's reliability.

Related Skills

Explore More Product & Management Skills→
electroheadfxelectroheadfx
4

gsd-health

Diagnose planning directory health and identify missing files or invalid configuration.

Community
Advanced
pradeepmoulipradeepmouli
2

speckit-workflows-enhance

Generate enhancement documents with MIN/MAX tasks from Speckit workflow configuration.

Community
Intermediate
ThiagoVitaleThiagoVitale

gsd-import

Import external plan files into a GSD planning system and detect conflicts with existing project decisions.

Community
Advanced
Pear-CommercePear-Commerce

gsd-health

Diagnose integrity issues in GSD project `.planning/` directories and optionally repair them.

Official
Intermediate