gpd-check-todos

Identify pending research todos and route them to appropriate actions in GPD projects.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill identifies and surfaces all pending research todos from the current GPD project, then enables selecting one to load its full context and route it to the appropriate action within a structured, auditable workflow.

Core Features & Use Cases

  • List pending todos with title, area, and age.
  • Filter by area to focus on analytical, numerical, validation, writing, or formalism tasks.
  • Load full context for the selected todo, including problem and solution summaries and related files.
  • Check roadmap alignment and available actions before deciding how to proceed.
  • Execute actions such as Work on it now, Add to phase plan, Brainstorm approach, or Create a phase.
  • Update STATE.md and commit changes automatically when a todo is completed.

Quick Start

Run the check-todos workflow and select a numbered todo to load its full context and proceed with an action.

Frequently Asked Questions about gpd-check-todos

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

FAQPage Schema
How do I surface and manage pending research todos in an interactive workflow?

Surface pending research todos by running the check-todos workflow, which lists items with title, area, and age, then lets you select one to load full context and route it to an appropriate action.

How do I filter research todos by specific work areas like formalism or validation?

Filter research todos by area to focus on analytical, numerical, validation, writing, or formalism tasks, allowing you to narrow down the pending list to a specific domain of your structured workflow.

Can I check roadmap alignment before deciding what action to take on a research todo?

You can check roadmap alignment and available actions before deciding how to proceed with a selected todo, ensuring the task fits your project phase plan before execution.

What actions can I execute after loading context for a selected research todo?

After loading context, execute actions such as Work on it now, Add to phase plan, Brainstorm approach, or Create a phase to route the todo appropriately within your structured workflow.

Do I need a GPD runtime and specific files to use this todo management workflow?

You need integration with the GPD runtime, access to .gpd/STATE.md and ROADMAP.md, and the ability to move items between todo directories, update STATE.md, and commit changes to operate.

Why does the workflow automatically update STATE.md and commit changes when a todo is completed?

STATE.md is updated and changes are committed automatically when a todo is completed to maintain an auditable state-management record within the GPD-enabled project environment.