gsd-health

Validate and repair planning directory integrity with the --repair flag.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/GenproMM/MMLab_TOOLS --skill gsd-health-genpromm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-health
Source: https://github.com/GenproMM/MMLab_TOOLS/tree/main/.claude/skills/gsd-health
Command: npx skills add https://github.com/GenproMM/MMLab_TOOLS --skill gsd-health-genpromm

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you diagnose and repair issues within your planning directory, ensuring a consistent and reliable workflow.

Core Features & Use Cases

  • Directory Health Check: Validate the integrity of your .planning/ directory.
  • Problem Reporting: Report actionable issues such as missing files, invalid configurations, and inconsistent states.
  • Repair Option: Optionally repair identified issues with the --repair flag.
  • Use Case: Regularly use this Skill to keep your planning directory in top condition, avoiding unexpected workflow disruptions.

Quick Start

Check the health of your planning directory and repair any issues using: run gsd-health --repair.

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 health of my project planning directory?

To check planning directory health, run a validation script that scans your `.planning/` directory for missing files, invalid configurations, and inconsistent states. It then reports actionable issues so you can resolve workflow disruptions proactively.

Can I automatically repair inconsistent states and missing files in my workflow directory?

Yes, you can repair inconsistent workflow directory states by running the validation command with the `--repair` flag. This automatically executes repair actions to fix identified issues like missing files and invalid configurations, restoring directory integrity.

What issues cause a planning directory to become inconsistent?

Planning directory inconsistency is typically caused by missing files, invalid configurations, and inconsistent states. Running a health diagnosis detects these specific issues and provides actionable feedback to help you avoid unexpected workflow maintenance disruptions.

Does this directory repair tool require any external dependencies?

No, this directory repair tool requires no external dependencies to validate and repair your planning directory. It operates independently using internal scripts to diagnose issues and execute repairs with the `--repair` flag.

When should I run a planning directory health check?

You should run a planning directory health check regularly to keep your project workflow in top condition. Frequent issue diagnosis helps catch missing files and invalid configurations early, avoiding unexpected workflow disruptions before they impact your project.