gpd-add-todo

Capture GPD session ideas as structured todos with frontmatter and Git commits.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/MichaelsEngineering/get-physics-done-test --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/get-physics-done-test/tree/main/.agents/skills/gpd-add-todo
Command: npx skills add https://github.com/MichaelsEngineering/get-physics-done-test --skill gpd-add-todo-michaelsengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool captures ideas or tasks surfaced during Get Physics Done (GPD) sessions and converts them into structured to-dos to ensure nothing is lost in the research workflow.

Core Features & Use Cases

  • Route ideas from live conversations into a tracked todo with provenance and timestamps.
  • Create .gpd/todos/pending entries with frontmatter including title, area, and related files.
  • Update .gpd/STATE.md and commit changes to maintain an auditable record of pending work and completed actions.

Quick Start

Provide a concise prompt or title for the idea to capture, and the workflow will create the Todo in .gpd/todos/pending, update STATE.md, and commit the changes.

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 ideas as structured todos during a research workflow?

You can capture ideas as structured todos by providing a concise prompt to the add-todo workflow, which extracts content, infers areas, and creates todo files under .gpd/todos/pending with frontmatter.

How does state management work when adding a new todo?

State management works by automatically updating .gpd/STATE.md and committing changes to Git after creating a new todo file, ensuring an auditable record of pending work and synchronization.

Can I create todos without an existing project setup?

Yes, you can create todos without an existing project setup. The workflow works with or without a project and stores all todos under the .gpd/todos directory structure.

How does duplicate detection work for todo entries?

Duplicate detection works by analyzing conversation content and arguments during the routing process, resolving duplicates before creating the todo file to prevent redundant pending entries.

What is the best way to track pending tasks from a GPD session?

The best way to track pending tasks is routing ideas through the add-todo workflow, which creates .gpd/todos/pending entries with provenance, timestamps, and related file metadata before updating state.

Does adding a todo require manual Git commits for state synchronization?

No, adding a todo does not require manual Git commits. The workflow automatically commits changes to maintain an auditable record and synchronize state after creating the todo file.