gsd-health

Validate and optionally repair issues in the .planning/ directory.

Updated Jan 21, 2026
One-click install
npx skills add https://github.com/zerAda/RestaurantAgentAutomation --skill gsd-health-zerada
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-health
Source: https://github.com/zerAda/RestaurantAgentAutomation/tree/main/.agent/skills/gsd-health
Command: npx skills add https://github.com/zerAda/RestaurantAgentAutomation --skill gsd-health-zerada

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill addresses the issue of ensuring the integrity and health of the .planning/ directory, detecting and repairing potential issues that may arise.

Core Features & Use Cases

  • Directory Integrity Validation: Checks for missing files, invalid configurations, and inconsistent states within the .planning/ directory.
  • Optional Repair: With the --repair flag, the Skill can attempt to fix detected issues automatically.
  • Use Case: For a project manager who needs to maintain the .planning/ directory, this Skill can save time by automating the health check process and fixing common issues without manual intervention.

Quick Start

Run the gsd-health skill to diagnose and optionally repair health issues in the .planning/ directory by executing the command: ./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 the integrity of my project planning directory?

Run a directory integrity check to scan the `.planning/` folder for missing files, invalid configurations, and inconsistent states. This validation ensures your project planning data remains available and structurally sound.

Can I automatically repair inconsistent states in my .planning directory?

Yes, you can automatically repair inconsistent states in the `.planning/` directory by running the health check script with the `--repair` flag, which attempts to fix detected issues without manual intervention.

What issues commonly cause a .planning directory health check to fail?

A `.planning/` directory health check commonly fails due to missing files, invalid configurations, and inconsistent data states. These issues compromise the integrity and availability of your project planning data.

Does this directory health check require any external dependencies to run?

No, this directory health check does not require any external dependencies. It operates as a standalone script to validate and optionally repair your `.planning/` directory environment.

What is the best way to automate planning maintenance for missing files?

The best way to automate planning maintenance for missing files is to run a script that validates the `.planning/` directory structure and uses a repair flag to automatically fix detected inconsistencies.