gsd-health

Validate .planning directory integrity and monitor session context utilization.

1|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/nnexai/git-stacks --skill gsd-health-nnexai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-health
Source: https://github.com/nnexai/git-stacks/tree/main/.codex/skills/gsd-health
Command: npx skills add https://github.com/nnexai/git-stacks --skill gsd-health-nnexai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses configuration drift and integrity issues within the .planning directory, ensuring that project workflows remain stable and reliable.

Core Features & Use Cases

  • Integrity Validation: Scans the .planning directory for missing files, invalid configurations, and orphaned plans.
  • Context Monitoring: Analyzes current session token utilization to prevent reasoning degradation.
  • Automated Repair: Provides an optional repair flag to fix detected configuration inconsistencies automatically.

Quick Start

Invoke the gsd-health skill to perform a full diagnostic check on your current planning directory and report any actionable issues.

Frequently Asked Questions about gsd-health

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

FAQPage Schema
How do I validate the structural integrity of a .planning directory?

To validate the structural integrity of a .planning directory, run a diagnostic scan that checks for missing files, invalid configurations, and orphaned plans to ensure your project workflow remains stable.

Why does my agent-based planning environment experience configuration drift?

Configuration drift in an agent-based planning environment occurs when the .planning directory accumulates invalid configurations and orphaned plans over time, which you can detect and repair using automated diagnostic routines.

How do I fix orphaned plans and invalid configurations in my project workspace?

You can fix orphaned plans and invalid configurations in your project workspace by executing diagnostic routines with an optional repair flag to automatically resolve detected inconsistencies within the planning directory.

When do I need to reset my workflow to prevent reasoning degradation?

You need to reset your workflow to prevent reasoning degradation when session context token utilization exceeds specific thresholds, which you can monitor by analyzing current session health status.

Can I automatically repair configuration inconsistencies in a planning directory?

Yes, you can automatically repair configuration inconsistencies in a planning directory by invoking a health diagnostic with an optional repair flag to fix detected structural issues and maintain a consistent environment.

What are the limitations of monitoring session context utilization for health status?

Monitoring session context utilization for health status is limited to analyzing token thresholds to recommend workflow resets, meaning it prevents reasoning degradation but does not fix underlying structural planning directory issues.