skills.rest
MichaelsEngineering
MichaelsEngineeringCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

gpd-show-phase

Inspect a research phase's artifacts, completion status, and verification results.

Updated Mar 15, 2026
Search Tags:#verification#roadmap#status report#research workflow#scientific research#gpd#phase inspection
One-click install
npx skills add https://github.com/MichaelsEngineering/get-physics-done-test --skill gpd-show-phase-michaelsengineering
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gpd-show-phase
Source: https://github.com/MichaelsEngineering/get-physics-done-test/tree/main/.agents/skills/gpd-show-phase
Command: npx skills add https://github.com/MichaelsEngineering/get-physics-done-test --skill gpd-show-phase-michaelsengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When running multi-phase research projects with Get Physics Done (GPD), it is hard to quickly see what a single phase accomplished, which plans are done, and whether results were verified. This Skill produces a structured report for one phase so you get situational awareness without manually reading every file. ## Core Features & Use Cases - Plan Completion Tracking: Lists every PLAN.md in the phase and marks whether a matching SUMMARY.md exists. - Key Results Extraction: Pulls one-liners, key results, and equations from phase summaries via the GPD CLI. - Verification & Convention Reporting: Shows verification/validation status and any convention changes recorded in summary frontmatter. - Use Case: After an overnight research run on plasma turbulence modeling, ask for a report on phase 3 to see which plans completed, what equations were derived, and whether verification passed before starting the next phase. ## Quick Start Ask the assistant to show the status and results of phase 3 of the current GPD research project.

Frequently Asked Questions about gpd-show-phase

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

FAQPage Schema
How do I check the status of a research phase in Get Physics Done?▼

Run the show-phase workflow with the phase number as the argument. It initializes phase context through the GPD runtime CLI, lists the phase directory, and reports plan completion, key results, and verification status in a structured ASCII report.

What information does a GPD phase report include?▼

The report includes the phase goal and dependencies from ROADMAP.md, a plan completion table, key results and equations extracted from summaries, verification and validation status, convention changes from affects fields, and a file listing with sizes.

What happens if the phase number I give does not exist?▼

The workflow checks the phase_found flag from the GPD init command. If the phase is not found, it displays the available phases from the roadmap along with usage instructions and exits without producing a report.

Does gpd-show-phase require a GPD project to be initialized?▼

Yes. The skill requires a .gpd/ROADMAP.md file and calls the GPD runtime CLI with the project config directory. Without an initialized GPD project containing phase directories and a roadmap, the inspection cannot run.

How are convention changes tracked in a research phase?▼

Each SUMMARY.md can declare an affects field in its frontmatter listing conventions established or changed, such as notation or sign conventions. The report collects these across all summaries in the phase and lists them in a dedicated section.

Related Skills

Explore More Education & Research Skills→
CharGrnmnCharGrnmn
1

gpd-add-phase

Add a new research phase to a GPD project roadmap.

Community
Intermediate
TMI-appsTMI-apps
2

implement

Load DEVELOPMENT_PLAN.md, resolve the next pending phase, and execute its steps with gates.

Official
Advanced
CharlieGreenmanCharlieGreenman
1

gpd-show-phase

Inspect a research phase and generate a structured ASCII report.

Community
Advanced
MichaelsEngineeringMichaelsEngineering

gpd-quick

Execute small ad-hoc research tasks with atomic commits and state tracking.

Community
Advanced