qsd-health

Diagnose and repair .planning directory issues for healthy qsd workflows.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/thecomputer07/qsd --skill qsd-health
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qsd-health
Source: https://github.com/thecomputer07/qsd/tree/main/skills/qsd-health
Command: npx skills add https://github.com/thecomputer07/qsd --skill qsd-health

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and repair issues in the planning directory to maintain healthy qsd workflows.

Core Features & Use Cases

  • Validates the .planning directory integrity, identifying missing files, misconfigurations, and inconsistent state.
  • Detects orphaned plans and potential workflow gaps, enabling proactive maintenance.
  • Supports optional repair mode via the --repair flag to automate remediation where safe.

Quick Start

Run the health workflow against your local qsd setup to inspect and optionally repair planning health.

Frequently Asked Questions about qsd-health

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

FAQPage Schema
How do I diagnose planning directory issues in qsd workflows?

To diagnose planning directory issues, run the health workflow script which validates .planning directory integrity and identifies missing files, invalid configurations, and orphaned plans across your qsd workflows.

What does a .planning directory health check validate?

A .planning directory health check validates workflow integrity by detecting missing files, misconfigurations, inconsistent state, and orphaned plans to maintain healthy qsd automation and deployment workflows.

Can I automatically repair orphaned plans and inconsistent configurations?

Yes, you can automatically repair orphaned plans and inconsistent configurations by executing the health workflow script with the --repair flag to automate safe remediation across your planning directory.

Does the qsd health check work with production deployment and scripting workflows?

Yes, the qsd health check applies to .planning directory health verification across QA, production deployments, and scripting workflows, integrating with the local Claude qsd workflow state.

What is the best way to maintain healthy qsd workflow state?

The best way to maintain healthy qsd workflow state is to run end-to-end health verification that loads the health workflow script, parses the --repair flag, and checks for missing files and inconsistencies.