gpd-health

Identify and report health status of Get Physics Done projects.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/MichaelsEngineering/get-physics-done-test --skill gpd-health-michaelsengineering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gpd-health
Source: https://github.com/MichaelsEngineering/get-physics-done-test/tree/main/.agents/skills/gpd-health
Command: npx skills add https://github.com/MichaelsEngineering/get-physics-done-test --skill gpd-health-michaelsengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Run comprehensive health checks on a Get Physics Done (GPD) project to detect structural, configuration, and environment issues, with optional auto-fix capabilities.

Core Features & Use Cases

  • Perform environment validation, repository structure checks, config integrity, and roadmap consistency.
  • Propose remediation steps and optionally apply fixes when the --fix flag is used.
  • Generate a clear health report with actionable guidance for improving project health.

Quick Start

Run a comprehensive health check on your GPD project and use --fix to automatically 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 a health check on my project configurations and validate repository structure?

To run a project health check, the Skill validates state files under .gpd, state.json, and config.json to identify structural, configuration, and environment issues. It then generates a clear health report with actionable guidance for improving project health.

Can I automatically fix environment and configuration issues detected during a project health check?

Yes, you can automatically fix detected issues by using the --fix flag. The Skill proposes remediation steps and optionally applies fixes to repair environment, configuration, and structure validation problems automatically.

What does a GPD project health check validate to ensure roadmap consistency?

A GPD project health check validates project configurations, environment checks, structure validation, and roadmap consistency. It uses the GPD runtime to inspect state files and ensure your project setup aligns with the intended roadmap.

Do I need specific state files to perform a project structure validation and health check?

Yes, you need state files under the .gpd directory, specifically state.json and config.json. The health check validates these files to detect configuration integrity issues and structural problems within your project.

What is the best way to report and fix DevOps environment issues in a project?

The best way to report and fix DevOps environment issues is to run a comprehensive health check with the --fix flag. This validates your environment, proposes remediation steps, and optionally applies fixes to resolve detected problems.

Why is my GPD project health check not catching configuration integrity issues?

If the health check is not catching configuration issues, verify that your state.json and config.json files are properly formatted under the .gpd directory. The Skill relies on the GPD runtime to validate these specific state files for accurate detection.