pi-todo

Tracks ad-hoc todo items for quick bug fixes and small multi-step changes.

Updated Nov 7, 2024
One-click install
npx skills add https://github.com/jeremysball/dotfiles --skill pi-todo-jeremysball
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pi-todo
Source: https://github.com/jeremysball/dotfiles/tree/main/.pi/skills-archive/pi-todo
Command: npx skills add https://github.com/jeremysball/dotfiles --skill pi-todo-jeremysball

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a user fires off several small requests in one message—"fix this bug and also update that logging"—it is easy to lose track of what has been done. This Skill provides a lightweight todo list so informal, multi-part requests are captured, tracked, and visibly completed without the overhead of a formal spec workflow. ## Core Features & Use Cases - Ad-hoc task capture: Create todos on the fly when the user mentions multiple small changes in a single message. - Automatic progress display: The todo list prints to chat automatically as items are completed, so no manual status reporting is needed. - Full list management: Add, complete, uncomplete, remove, clear, and reprioritize todos, plus user-facing /todos and /todo-clear commands. - Use Case: A user says "Fix the login button color and also add validation to the form." The assistant creates two todos, completes each in turn, and the chat shows progress until both are done. ## Quick Start Ask the assistant to fix a couple of small bugs in one message and it will create and work through a todo list automatically.

Frequently Asked Questions about pi-todo

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

FAQPage Schema
How do I track multiple small tasks in one chat message?

Mention all the tasks in your message and the assistant creates a todo for each one. As each task finishes, the todo is marked complete and the updated list prints to chat automatically.

When should I use the todo tool versus prd-exec?

Use the todo tool for informal, ad-hoc requests like quick bug fixes mentioned in passing. Use prd-exec, prd-start, or prd-next when implementing features from a formal PRD or specification.

What commands are available to manage the todo list?

The tool supports list, add, complete, uncomplete, remove, clear, and prioritize actions. Users can also run /todos to view the current list and /todo-clear to delete all todos.

Should I create a todo for a single quick fix?

No. If you are doing one thing immediately, just do it. Todos are meant for work spanning multiple steps or interactions, not single actions completed right away.

Can I reorder or reopen todos after creating them?

Yes. The prioritize action reorders todos by a list of ids, and uncomplete reopens a previously completed todo if the work needs to be revisited.