gsd-health

Detects and reports missing files and invalid or orphaned entries in .planning directories.

1|Updated Aug 17, 2025
One-click install
npx skills add https://github.com/DuySeu/StockMind --skill gsd-health-duyseu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-health
Source: https://github.com/DuySeu/StockMind/tree/main/.agent/skills/gsd-health
Command: npx skills add https://github.com/DuySeu/StockMind --skill gsd-health-duyseu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Inconsistent planning directories and misconfigurations can derail automated workflows. This skill identifies integrity issues in the .planning directory and reports actionable guidance to restore configuration and state.

Core Features & Use Cases

  • Validate the integrity of the .planning/ directory, detecting missing files, invalid configurations, and orphaned plans.
  • Generate clear, actionable reports and guidance to fix issues, with optional automated repair via a --repair flag.
  • Supports end-to-end health checks for planning workflows across multiple projects and environments.

Quick Start

Run the health workflow on your planning directory to validate integrity and optionally apply repairs.

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 a .planning directory?

You can validate planning directory integrity by running a health workflow that detects missing files, invalid configurations, inconsistencies, and orphaned plans, returning structured findings for actionable guidance.

What causes orphaned plans and inconsistencies in a planning directory?

Orphaned plans and inconsistencies in a planning directory stem from misconfigurations and missing files that derail automated workflows, requiring integrity validation to identify and report actionable guidance.

Can I automatically repair invalid configurations in my .planning directory?

Yes, you can automatically repair invalid configurations by passing a --repair flag to the health workflow, which applies optional remediation to restore directory state and configuration.

Does the planning directory health check support multiple project environments?

Yes, the planning directory health check supports end-to-end validation across multiple projects and environments, auditing directory integrity to ensure consistent automated workflows.

What is the best way to fix missing files in a .planning directory?

The best way to fix missing files in a .planning directory is to run a health check workflow with the --repair flag to apply optional automated remediation and restore configuration state.