health

Validate the integrity of the .planning/ directory and report issues.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill identifies and helps resolve issues within your project's planning directories, ensuring consistency and preventing errors in your workflow.

Core Features & Use Cases

  • Integrity Validation: Checks for missing files, invalid configurations, and inconsistent states within .planning/.
  • Error Reporting: Clearly lists critical errors, non-critical warnings, and informational notes.
  • Auto-Repair: Optionally fixes common, auto-fixable issues to restore project health.
  • Use Case: Before starting a new development sprint, run this health check to ensure all project configuration files are present and correctly formatted, preventing unexpected roadblocks.

Quick Start

Run the health check to validate the integrity of your planning directory.

Frequently Asked Questions about health

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

FAQPage Schema
How do I validate the integrity of my project planning directory?

To validate project planning directory integrity, run a health check to identify missing files, invalid configurations, and inconsistent states within the `.planning/` folder, preventing unexpected workflow errors.

Can I automatically repair inconsistent states in my `.planning/` folder?

Yes, you can automatically repair inconsistent states in your `.planning/` folder. The health check optionally fixes common, auto-fixable issues to restore project health and configuration consistency.

What are common causes of workflow errors in project planning directories?

Common causes of workflow errors in project planning directories include missing configuration files, invalid formatting, and inconsistent states. A health check identifies these critical errors and warnings before starting a development sprint.

Do I need Node.js to run a health check on my planning configurations?

Yes, you need Node.js installed to run this health check. The validation process requires Node.js and specifically executes the `gsd-tools.cjs` script to scan and repair your project planning directory.

What is the best way to ensure planning integrity before a development sprint?

The best way to ensure planning integrity before a development sprint is running a health check. This validates that all project configuration files are present, correctly formatted, and free of inconsistent states.