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

gpd-progress

Reports research progress and routes to the next GPD workflow action.

Updated Mar 18, 2026
Search Tags:#roadmap#status report#workflow routing#research progress#gpd#physics research#state reconciliation
One-click install
npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-progress-michaelsengineering
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gpd-progress
Source: https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics/tree/main/.agents/skills/gpd-progress
Command: npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-progress-michaelsengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Research projects tracked with the GPD (Get Physics Done) framework accumulate phases, plans, summaries, and state files that are hard to keep in sync mentally. This Skill gives you instant situational awareness of where your research stands and tells you exactly which command to run next. ## Core Features & Use Cases - Progress Reporting: Generates a rich status report with a progress bar, recent work summaries, key decisions, accumulated physics insights, blockers, and pending tasks. - Smart Routing: Analyzes plan/summary/verification counts in the current phase and routes to the right next action — execute a plan, plan a phase, fix validation gaps, or complete a milestone (Routes A through F). - State Reconciliation: The --reconcile mode compares STATE.md against actual disk artifacts and offers to sync discrepancies. - Use Case: After returning to a turbulence research project, run the progress check to see that Phase 2 has an unexecuted plan, then follow the suggested $gpd-execute-phase 2 command to continue. ## Quick Start Ask the assistant to check my research progress and tell me what to do next, optionally with the --brief flag for a compact three-line status.

Frequently Asked Questions about gpd-progress

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

FAQPage Schema
How do I check research progress in a GPD project?▼

Invoke the progress command, which loads state, roadmap, and project context via the GPD CLI and presents a report with a progress bar, recent work, current position, and the recommended next command. Use --brief for a compact three-line status.

What does the gpd-progress skill do after showing status?▼

It counts plans, summaries, and verification files in the current phase, then routes to the next action: executing unexecuted plans, planning an unplanned phase, fixing validation gaps, or completing a milestone. It never acts without user confirmation.

What files are required for the progress check to work?▼

The skill requires a .gpd directory with ROADMAP.md and STATE.md. If ROADMAP.md is missing but PROJECT.md exists, it treats the milestone as archived and suggests starting a new milestone; if both are missing, it suggests creating a new project.

How do I fix STATE.md when it is out of sync with disk artifacts?▼

Run the progress check with the --reconcile flag. It compares STATE.md against actual plan and summary files on disk, shows a discrepancy table, and offers to sync STATE.md to disk reality using gpd state commands.

What happens when verification finds gaps in my research phase?▼

The routing logic detects VERIFICATION.md files with statuses like gaps_found or diagnosed. It then suggests planning gap fixes with $gpd-plan-phase --gaps, or executing existing gap-closure plans with $gpd-execute-phase --gaps-only.

Related Skills

Explore More Education & Research Skills→
CharGrnmnCharGrnmn
1

gpd-progress

Analyze project roadmap and state files to track research progress and suggest next actions.

Community
Advanced
gonz0wgonz0w
1

planner-gap-closure

Create gap-closure plans from VERIFICATION and UAT failures into PLAN.md.

Community
Advanced
benjaminshoemakerbenjaminshoemaker
39

phase-checkpoint

Execute and validate Phase Checkpoint criteria from EXECUTION_PLAN.md.

Community
Advanced
MichaelsEngineeringMichaelsEngineering

gpd-show-phase

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

Community
Intermediate