gsd-health

Diagnose planning directory integrity and analyze session context utilization.

Updated Apr 22, 2025
One-click install
npx skills add https://github.com/mcampbellr/.dotfiles --skill gsd-health-mcampbellr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-health
Source: https://github.com/mcampbellr/.dotfiles/tree/main/claude/.claude/skills/gsd-health
Command: npx skills add https://github.com/mcampbellr/.dotfiles --skill gsd-health-mcampbellr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The gsd-health skill addresses the need for ensuring the health and proper functioning of your .planning/ directory, which can be crucial for maintaining a productive workflow.

Core Features & Use Cases

  • Directory Health Check: Validates the integrity of the .planning/ directory.
  • Context Utilization Analysis: Evaluates the running session's context utilization to prevent degradation in reasoning quality.
  • Repair and Context Flags: Offers the option to repair issues and analyze context utilization with --repair and --context flags.

Quick Start

Run the gsd-health skill to diagnose the health of your planning directory with gsd-health.

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 for missing files or invalid configurations?

Run a health diagnostic to validate the directory, detect missing files, and flag orphaned plans. This planning directory integrity check identifies invalid configurations so you can maintain a stable workflow.

What causes reasoning quality degradation in a running session and how can I monitor it?

Excessive context utilization causes reasoning quality degradation in a running session. Run a context analysis to evaluate session context utilization and proactively prevent degradation before it impacts performance.

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

Yes, you can repair orphaned plans and invalid configurations by running the health diagnostic with a repair flag. This executes repair actions to fix detected directory issues and restore planning integrity.

When should I run a context utilization analysis on my planning directory?

Run a context utilization analysis during heavy workloads or before complex tasks to prevent reasoning quality degradation. Use a context flag to evaluate running session context and maintain optimal performance.