gsd-health

Diagnose and report health issues in a .planning directory.

Updated Jan 28, 2025
One-click install
npx skills add https://github.com/aslaii/dotfiles --skill gsd-health-aslaii
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-health
Source: https://github.com/aslaii/dotfiles/tree/main/claude/skills/gsd-health
Command: npx skills add https://github.com/aslaii/dotfiles --skill gsd-health-aslaii

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses health issues in a .planning directory and proposes repairs to restore integrity and consistency.

Core Features & Use Cases

  • Health checks: Detect missing files, invalid configurations, and orphaned plans in .planning.
  • Drift detection: Identify drift between intended and actual planning state and report discrepancies.
  • Repair support: Optionally repair issues via the --repair flag by applying predefined fixes when safe.

Quick Start

Run the health workflow against your .planning directory to identify issues and automatically repair them when needed.

Frequently Asked Questions about gsd-health

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

FAQPage Schema
How do I diagnose planning directory health for missing files and invalid configurations?

Run a health check against your .planning directory to detect missing files, invalid configurations, and orphaned plans. The diagnostic pass parses the directory state and reports inconsistencies to restore planning integrity.

Can I automatically repair an inconsistent .planning directory state?

Yes, you can automatically repair an inconsistent .planning directory by passing the --repair flag. The health workflow applies predefined fixes to resolve detected configuration issues and missing files safely.

What is planning drift detection and how does it work for workflow validation?

Planning drift detection identifies discrepancies between your intended and actual planning state. The health workflow compares the expected directory structure against the current files, highlighting orphaned plans and inconsistent state for validation.

Does this health diagnostic tool require any external dependencies or components?

No, this health diagnostic tool requires no external dependencies or components. It works standalone by running the health workflow defined in your local environment to validate and repair the .planning directory.

Why are my workflow planning files showing invalid configurations during a health check?

Invalid configurations in your planning files are flagged during a health check when the directory state does not match the expected workflow schema. The diagnostic reports these mismatches so you can apply repairs using the --repair flag.

What's the best way to validate an initial .planning directory setup and detect orphaned plans?

The best way to validate an initial .planning directory setup is to run the health workflow diagnostic. It detects orphaned plans and missing files from the start, ensuring your planning workflow configuration remains consistent.