gsd-health

Diagnose planning directories for missing files, invalid configurations, and orphaned plans.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/ev3rlit/magam-canonical-archive --skill gsd-health-ev3rlit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-health
Source: https://github.com/ev3rlit/magam-canonical-archive/tree/main/.codex/skills/gsd-health
Command: npx skills add https://github.com/ev3rlit/magam-canonical-archive --skill gsd-health-ev3rlit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Planning directories often drift out of integrity as projects grow. This skill diagnoses health issues and suggests repair actions to restore a clean, consistent planning state.

Core Features & Use Cases

  • Automatic health checks for missing files, invalid configurations, and orphaned plans.
  • Actionable repair recommendations with safety checks and non-destructive remediation options.
  • Use cases include validating a new plan structure, auditing ongoing projects, and preparing a repair roadmap.

Quick Start

Run a health check on your planning directory to identify issues and apply suggested repairs if you opt in.

Frequently Asked Questions about gsd-health

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

FAQPage Schema
How do I audit a planning directory for missing files and inconsistent state?

You can diagnose planning directory health by running an automated audit that scans for missing files, invalid configurations, and orphaned plans. The skill enforces checks and reports actionable issues to restore a consistent planning state.

What is planning directory health and why does it drift out of integrity?

Planning directory health measures the consistency of project plan files and configurations. Directories drift as projects grow, creating orphaned plans and invalid states that require automated diagnosis to identify and resolve.

Can I automatically repair orphaned plans and invalid configurations without data loss?

Yes, you can repair orphaned plans and invalid configurations using non-destructive remediation options. The skill provides actionable repair recommendations with safety checks and only applies fixes when you explicitly opt in.

What's the best way to validate a new plan structure before starting a project?

The best way to validate a new plan structure is to run a health check that audits configurations and enforces file requirements. This diagnoses potential issues early and provides a repair roadmap if inconsistencies are found.

Do I need any dependencies to diagnose and repair planning directory health issues?

No dependencies are required to diagnose planning directory health issues. The skill operates independently to analyze configurations, audit missing files, and optionally perform repairs without requiring external components.