gsd-health

Diagnose planning directory health and repair issues with a --repair argument.

Updated Jan 25, 2026
One-click install
npx skills add https://github.com/MINT-IA/MINT --skill gsd-health-mint-ia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-health
Source: https://github.com/MINT-IA/MINT/tree/main/.claude/skills/gsd-health
Command: npx skills add https://github.com/MINT-IA/MINT --skill gsd-health-mint-ia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose planning directory health and repair issues.

Core Features & Use Cases

  • Validate planning directory integrity and surface actionable issues.
  • Detect missing files, invalid configurations, inconsistent state, and orphaned plans.
  • Use Case: Run health checks in CI or local development to ensure planning workflows remain consistent.

Quick Start

Run the gsd-health skill to validate the planning directory and repair issues with --repair if needed.

Frequently Asked Questions about gsd-health

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

FAQPage Schema
How do I validate planning directory integrity and detect missing files?

To validate planning directory integrity, run a health check workflow that scans for missing files, invalid configurations, and inconsistent state. This diagnostic process surfaces actionable issues in your local workspace or CI pipeline.

What causes orphaned plans and inconsistent state in workflow planning directories?

Orphaned plans and inconsistent state in planning directories occur when workflow files become desynchronized or misconfigured. Automated health diagnostics detect these issues by validating directory structure and identifying invalid configurations.

Can I automatically repair invalid configurations and orphaned plans in a planning directory?

Yes, you can automatically repair invalid configurations and orphaned plans by running the health workflow with the --repair argument. This passes through to the workflow to fix detected directory issues end-to-end.

Does planning directory health validation work for CI pipelines and local development workspaces?

Planning directory health validation works for both CI pipelines and local development workspaces. It executes the health workflow end-to-end to ensure planning workflows remain consistent across different environments.

What is the best way to automate workflow diagnostics for planning directory issues?

The best way to automate workflow diagnostics for planning directories is running an end-to-end health check that detects missing files and inconsistent state. Use the --repair argument to automatically fix surfaced issues during validation.