skills.rest
AO-Cyber-Systems
AO-Cyber-SystemsOFFICIAL
Explore all skills by this author →
GitHub

df:health

Diagnose .planning directory integrity issues across DevFlow projects and repair them.

Updated Feb 6, 2026
Search Tags:#automation#workflow#planning#integrity#diagnose#health#devflow
One-click install
npx skills add https://github.com/AO-Cyber-Systems/devflow-claude --skill df-health
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: df:health
Source: https://github.com/AO-Cyber-Systems/devflow-claude/tree/main/skills/df-health
Command: npx skills add https://github.com/AO-Cyber-Systems/devflow-claude --skill df-health

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose planning directory health and optionally repair issues. Use when the user wants to check project integrity or troubleshoot DevFlow state.

Core Features & Use Cases

  • Validate the .planning/ directory for missing files, invalid configurations, and inconsistent state.
  • Detect orphaned jobs or misconfigurations in DevFlow workflows.
  • Provide actionable repairs or guidance to restore healthy state of a project.

Quick Start

Run the health workflow from @~/.claude/devflow/workflows/health.md to validate and repair the planning directory.

Frequently Asked Questions about df:health

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

FAQPage Schema
How do I check DevFlow project integrity and validate the planning directory?▼

To check DevFlow project integrity, run a health diagnosis on the .planning directory to detect missing files, invalid configurations, and inconsistent state. This validation identifies misconfigurations and orphaned jobs across your workflows.

What is the best way to repair orphaned jobs and misconfigurations in DevFlow workflows?▼

The best way to repair orphaned jobs and misconfigurations is to run the health workflow with the --repair flag. This applies automated fixes to restore the DevFlow project directory to a healthy state.

Why does my DevFlow workflow fail when the .planning directory has missing files?▼

DevFlow workflows fail due to missing files because the .planning directory lacks required state integrity. Diagnosing planning health verifies directory contents and restores missing configurations to resolve the failure.

Can I automate troubleshooting for inconsistent DevFlow state across multiple projects?▼

Yes, you can automate troubleshooting for inconsistent DevFlow state by executing the health workflow. It systematically verifies directory integrity, detects orphaned jobs, and applies repairs across DevFlow projects.

Do I need any dependencies to diagnose DevFlow planning directory health?▼

No dependencies are required to diagnose DevFlow planning directory health. The diagnostic workflow operates independently to validate directory integrity, find missing files, and detect misconfigurations.

Related Skills

Explore More Software Engineering Skills→
jinglemansweepjinglemansweep

jp-plan

Automates Git-based .plans phase directory creation with sequential numbering and metadata files.

Community
Advanced
missdeermissdeer

cmake-build

Manage Windows CMake build, clean, and reconfigure workflows for GarmentStyleMatch.

Community
Intermediate
yutsukiokayutsukioka

apex-generate-admin-profile

Generate Admin Profiles with CAPEL character controls and UN-style language from job history and descriptions.

Community
Advanced
khrorekhrore

nix-repro-env

Inspect Nix flake outputs and select correct CLI entrypoints for reproducible commands.

Community
Intermediate