gpd-check-todos

Lists pending research todos and routes a selected todo to an action.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --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/sentinel-multiscale-field-dynamics/tree/main/.agents/skills/gpd-check-todos
Command: npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-check-todos-michaelsengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Research projects accumulate scattered todos across analytical, numerical, validation, writing, and formalism areas, making it hard to decide what to work on next. This Skill lists all pending todos, loads full context for a selected item, and routes it to a concrete action such as starting work, planning a phase, or brainstorming. ## Core Features & Use Cases - Todo Listing and Filtering: Displays pending todos with title, area, and relative age, with optional area filters like analytical, numerical, validation, writing, or formalism. - Context Loading and Roadmap Correlation: Reads the selected todo file completely, summarizes referenced files, and checks whether the todo maps to an upcoming phase in ROADMAP.md. - Action Routing and State Updates: Moves completed todos to done/, updates STATE.md pending counts, and commits changes to git through the GPD CLI. - Use Case: A physics researcher returns to a project after a week, runs the todo check with the numerical filter, selects a convergence-check todo, and starts work on it immediately with full problem and solution context loaded. ## Quick Start Ask the assistant to list my pending research todos, optionally filtered by an area such as analytical or numerical, and help me pick one to work on.

Frequently Asked Questions about gpd-check-todos

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

FAQPage Schema
How do I list pending research todos by area?▼

Run the check-todos command with an area filter argument such as analytical, numerical, validation, writing, or formalism. Without a filter it shows all pending todos with title, area, and relative age as a numbered list.

How do I start working on a captured todo?▼

Reply with the todo's number from the list, review its loaded problem and solution context, then choose the Work on it now action. The todo file moves to .gpd/todos/done/, STATE.md is updated, and the change is committed to git.

Does the todo workflow integrate with a project roadmap?▼

Yes, it checks .gpd/ROADMAP.md for phases matching the todo's area or referenced files. When a match exists, the action options include adding the todo to that phase's plan instead of working on it immediately.

What happens if there are no pending todos?▼

The workflow reports that no pending todos exist and offers to continue with the current phase via gpd-progress or capture a new todo via gpd-add-todo. Todos are normally captured during work sessions.

Why does the GPD CLI command fail in the Codex runtime?▼

The ambient gpd on PATH may not match the Codex runtime. Use the pinned invocation /home/qol/.gpd/venv/bin/python -m gpd.runtime_cli --runtime codex --config-dir ./.codex --install-scope local, or set GPD_ACTIVE_RUNTIME=codex with uv run gpd.