gpd-health

Name: gpd-health
Availability: InStock
Author: CharlieGreenman

Run project health checks and auto-fix detected issues with structured JSON output.

1|Updated Mar 29, 2026

Search Tags:#automation #validation #configuration #ci-cd #git-status #health-checks #project-automation

Ready to run

npx skills add https://github.com/CharlieGreenman/roomtemp-superconductor-gpd --skill gpd-health

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: gpd-health
Source: https://github.com/CharlieGreenman/roomtemp-superconductor-gpd/tree/main/.agents/skills/gpd-health
Command: npx skills add https://github.com/CharlieGreenman/roomtemp-superconductor-gpd --skill gpd-health

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates comprehensive project health checks and optionally auto-fixes detected issues to keep repositories healthy and compliant.

Core Features & Use Cases

Environment and project structure validation to ensure consistency across the codebase.
Policy compliance checks (storage-path policy, state validity, roadmap integrity, and convention lock integrity).
Finite checks for plan frontmatter, latest return envelope, config.json validity, checkpoint tags, and git status, with optional automatic repair.

Quick Start

Run the health check on your project, optionally with --fix to auto-repair detected issues.

Frequently Asked Questions about gpd-health

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

FAQPage Schema

How do I run project health checks and auto-fix repository issues?▼

Run project health checks by executing the health command, which validates environment, structure, and git status, returning structured JSON with totals, passes, warnings, and failures. Append --fix to automatically repair detected issues.

What does a repository health check cover for CI-CD automation?▼

A repository health check covers environment validation, project structure consistency, storage-path policy compliance, state validity, plan integrity, and git status across typical development workflows to maintain healthy repos.

Can I automatically fix project structure and configuration validation errors?▼

Yes, you can automatically fix detected project structure and configuration validation errors by running the health command with the --fix option, which reports applied repairs alongside the summary of passes, warnings, and failures.

How do I validate plan integrity and git status in my development workflow?▼

Validate plan integrity and git status by running the project health check, which executes finite checks for plan frontmatter, checkpoint tags, and git status, then returns a structured JSON report detailing any warnings or failures.

What is the best way to maintain healthy repos and ensure policy compliance?▼

The best way to maintain healthy repos is running comprehensive health checks that validate storage-path policy, state validity, and convention lock integrity, optionally using --fix to auto-repair detected issues and ensure compliance.

Why does my project health check report warnings for state validity and config.json?▼

Project health check warnings for state validity and config.json occur when the finite checks detect non-compliance or invalid structures. The returned JSON report details these warnings, which can be auto-fixed using the --fix option.