gpd-add-todo

Captures research ideas and tasks as structured todo files with frontmatter and git commits.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-add-todo-michaelsengineering
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gpd-add-todo
Source: https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics/tree/main/.agents/skills/gpd-add-todo
Command: npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-add-todo-michaelsengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? During physics research sessions, ideas, checks, and follow-up tasks surface mid-conversation and are easily lost. This Skill captures them as structured todo files without breaking the current workflow, preserving enough context for a future session to act on them weeks later. ## Core Features & Use Cases - Context-Aware Capture: Extracts the task from explicit arguments or by analyzing the recent conversation, including file paths, equations, and parameter details. - Automatic Organization: Infers an area (analytical, numerical, literature, validation, etc.) from file paths, generates a slug-based filename, and writes frontmatter-tagged Markdown into .gpd/todos/pending/. - Duplicate Detection & State Tracking: Searches existing pending todos for overlaps, prompts for skip/replace/add resolution, updates STATE.md, and commits everything to git. - Use Case: While deriving an equation of motion, you realize a limiting case needs checking. Invoke the Skill with "Check limiting case where coupling constant vanishes" and it files a dated todo with problem and solution context, then commits it. ## Quick Start Ask the assistant to capture the current discussion point as a todo, for example by saying "add a todo to verify dimensional consistency of Eq. (17)".

Frequently Asked Questions about gpd-add-todo

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

FAQPage Schema
How do I capture a task or idea during a research session?▼

Invoke the add-todo workflow with an optional description, such as a short action-oriented title. Without arguments, it analyzes the recent conversation to extract the problem, relevant files, and technical details, then writes a structured todo file.

How does the todo capture detect duplicate tasks?▼

It greps existing files in .gpd/todos/pending for key words from the new title. If a potential overlap is found, it reads the existing todo and asks whether to skip, replace, or add the new one anyway.

Can I add todos without an initialized GPD project?▼

Yes. The add-todo workflow works standalone by creating the .gpd/todos/pending and .gpd/todos/done directories as needed, so no existing project gate is required.

How are research todos categorized by area?▼

Areas are inferred from file paths and content: derivations map to analytical, simulations to numerical, references to literature, tests to validation, and so on. Existing areas from prior todos are reused for consistency when a similar match exists.

What happens to the todo file after it is created?▼

The todo is written as Markdown with frontmatter containing created timestamp, title, area, and file references. STATE.md is updated with the pending todo count, and both files are committed to git via the GPD CLI.