gsd-health

Diagnose and repair integrity issues in the .planning directory.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures the integrity and proper functioning of your planning directories, identifying and fixing potential issues before they cause problems.

Core Features & Use Cases

  • Directory Health Check: Scans .planning/ for missing files, invalid configurations, and inconsistent states.
  • Automated Repair: Optionally attempts to fix identified issues.
  • Use Case: If your AI agent's planning process is failing due to corrupted or missing state files, this skill can diagnose the problem and attempt to restore the planning environment to a working condition.

Quick Start

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

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 health of my agent's planning directory?

To check planning directory health, scan the .planning directory for missing files, invalid configurations, and inconsistent states. This diagnosis identifies workflow integrity issues before they cause agent failures.

How do I repair a corrupted .planning directory for my AI agent workflow?

You can repair a corrupted .planning directory by running a health check with repair arguments. This attempts to fix missing files and invalid configurations, restoring the planning environment to a consistent, working condition.

Why does my AI agent workflow fail due to inconsistent planning states?

AI agent workflows fail due to inconsistent planning states when the .planning directory contains missing files or invalid configurations. Diagnosing directory integrity identifies these specific issues so you can repair the corrupted environment.

What is the best way to fix missing files in a .planning directory?

The best way to fix missing files in a .planning directory is running an automated repair workflow. It identifies the missing planning files and attempts to restore the agent's workflow integrity to a robust working state.

Can I diagnose workflow integrity issues without automatically repairing the planning directory?

Yes, you can diagnose workflow integrity issues without automatic repair by running the health check alone. It scans for missing files and invalid configurations, reporting the directory health status without modifying the planning environment.

When should I run a planning directory health check on my agent workflows?

You should run a planning directory health check when your AI agent's planning process is failing. Diagnosing directory integrity early identifies missing files and inconsistent states before they disrupt your workflow.