gsd-health

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

Updated May 22, 2026
One-click install
npx skills add https://github.com/yusaduymaz/loexai --skill gsd-health-yusaduymaz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-health
Source: https://github.com/yusaduymaz/loexai/tree/main/.codex/skills/gsd-health
Command: npx skills add https://github.com/yusaduymaz/loexai --skill gsd-health-yusaduymaz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It identifies problems in a planning directory so teams can catch missing files, broken configurations, inconsistent state, and orphaned plans before they derail execution.

Core Features & Use Cases

  • Directory Integrity Checks: Verifies that expected planning artifacts exist and that their relationships remain consistent.
  • Optional Repair Guidance: Supports repair-oriented runs that help restore a healthy planning state when issues are found.
  • Context Health Review: Evaluates session context utilization so users can decide whether to continue or start fresh.
  • Use Case: Use this Skill when a planning workspace feels out of sync and you need a clear audit of what is missing, invalid, or stale.

Quick Start

Ask the gsd-health skill to inspect the planning directory and report any missing files, invalid configurations, orphaned plans, or context warnings.

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?

Planning directory audits detect missing files, invalid configurations, and inconsistent state by verifying artifact relationships. This diagnostic process identifies orphaned plans and reports actionable findings to prevent execution failures.

What is planning directory health validation and when do I need it?

Planning directory health validation is the process of checking workspace artifacts for integrity and consistency. You need it when a planning workspace feels out of sync and you require a clear audit of what is missing, invalid, or stale.

Can I repair orphaned plans and broken configurations automatically?

You can repair orphaned plans and broken configurations through optional repair-oriented runs. These runs provide guidance to help restore a healthy planning state when issues are found, rather than automatically modifying files without oversight.

How do I check if my session context utilization is healthy enough to continue?

To check session context utilization, you perform a context health review that evaluates how well your current context is being used. This review helps you decide whether to continue the existing session or start fresh.

Does planning directory validation work without creating premature workflow artifacts?

Planning directory validation works without creating premature workflow artifacts by relying on flag parsing and artifact verification. It generates actionable reporting directly from the audit without adding new files to your workspace prematurely.

What is the best way to diagnose inconsistent state in a GSD planning workflow?

The best way to diagnose inconsistent state in a GSD planning workflow is to run an end-to-end audit that validates artifact relationships and detects orphaned plans. This approach catches broken configurations before they derail execution.