shine-health

Diagnose .planning directory health issues and report actionable insights.

1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/diShine-digital-agency/SHINE-Code-System --skill shine-health
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shine-health
Source: https://github.com/diShine-digital-agency/SHINE-Code-System/tree/main/skills/shine-health
Command: npx skills add https://github.com/diShine-digital-agency/SHINE-Code-System --skill shine-health

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose planning directory health issues and report actionable insights.

Core Features & Use Cases

  • Validates presence and integrity of critical files in .planning directories.
  • Detects misconfigurations, inconsistencies, and orphaned plans to prevent stalled work.
  • Use Case: A product team can run health checks to ensure all required plan artifacts exist before a release.

Quick Start

Run the health check on the current .planning directory and repair issues when the --repair flag is provided.

Frequently Asked Questions about shine-health

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

FAQPage Schema
How do I diagnose planning directory health issues in SHINE workflows?▼

To diagnose planning directory health, run the health workflow located at @~/.claude/shine/workflows/health.md. It scans .planning directories to detect missing files, misconfigurations, inconsistencies, and orphaned plans, then reports actionable insights.

What causes orphaned plans and misconfigurations in a .planning directory?▼

Orphaned plans and misconfigurations in a .planning directory occur when required plan artifacts are missing or critical files lack integrity. These inconsistencies can stall work and prevent a smooth release if not validated beforehand.

Can I automatically repair missing files and inconsistencies in my .planning directory?▼

Yes, you can repair missing files and inconsistencies by passing the --repair flag. This instructs the health workflow to apply fixes directly to the detected issues within the .planning directory.

Do I need a specific environment to run SHINE health checks on my project?▼

You need the SHINE health workflow installed at @~/.claude/shine/workflows/health.md and a .planning directory present in your project. The Skill applies to SHINE workflows across projects to validate directory structure.

What is the best way to ensure all required plan artifacts exist before a release?▼

The best way to ensure plan artifacts exist before a release is to run a health check on the .planning directory. It validates the presence and integrity of critical files to prevent stalled work.