gpd-debug

Diagnoses physics calculation issues with persistent debug sessions and structured root-cause reports.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging of physics calculations with persistent state across context resets to diagnose root causes while preserving investigation context.

Core Features & Use Cases

  • Persistent debug sessions that survive resets and track progress
  • Parallel debugger agents to triage multiple symptoms concurrently
  • Structured root-cause reports that automatically update VERIFICATION.md

Quick Start

Spawn a gpd-debugger to diagnose the current verification gaps and collect root-cause findings.

Frequently Asked Questions about gpd-debug

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

FAQPage Schema
How do I debug physics calculations without losing context across resets?

Debug physics calculations using a structured workflow with persistent state that survives context resets. Parallel agents triage multiple symptoms concurrently, preserving investigation context and tracking progress throughout the session.

What is root-cause analysis for physics simulation issues and when do I need it?

Root-cause analysis for physics simulations systematically diagnoses calculation errors and collects evidence. You need it for complex derivation workflows where early diagnosis is required to identify underlying causes of verification failures.

How do I start a debug session for reproducible physics research?

Start by spawning a debugger agent to diagnose current verification gaps and collect root-cause findings. The skill requires a SKILL.md file at the root with YAML frontmatter containing name and description, plus optional scripts and references directories.

Can I run parallel debugger agents to triage multiple physics symptoms at once?

Yes, parallel debugger agents can triage multiple symptoms concurrently during physics debugging. Each agent investigates separate issues while sharing the same persistent debug session state across context resets.

What outputs does a structured physics debugging workflow produce?

Structured physics debugging produces root-cause reports with collected evidence, updated verification gap documentation, and persistent debug sessions that track investigation progress across resets.

Does physics debugging work for complex simulation and derivation workflows?

Physics debugging targets complex simulation and derivation workflows specifically. It enables early diagnosis in these environments by using parallel agents and persistent state to handle intricate calculation chains.