todo

Manages idea and task journals in docs/todo markdown files through a draft-to-done lifecycle.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/lfuuu/claude-rules --skill todo-lfuuu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: todo
Source: https://github.com/lfuuu/claude-rules/tree/main/ai-billing/skills/todo
Command: npx skills add https://github.com/lfuuu/claude-rules --skill todo-lfuuu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Ideas and multi-phase tasks get lost or stay half-formed when there is no structured place to capture, stress-test, and track them before implementation. This Skill maintains a local task journal in docs/todo/NNN-<slug>.md files, guiding each entry through an explicit lifecycle: draft → grilled → resolved → done. ## Core Features & Use Cases - Idea capture with auto-numbering: The add subcommand creates a numbered, slugged markdown file (with Cyrillic transliteration) from a raw idea, using a consistent frontmatter template. - Stress-testing via grill-me: The grill-me subcommand orchestrates the global grill-me skill to interrogate a draft idea, logging every Q&A pair into the file's Drill section. - Decision and phase tracking: resolve extracts decisions (including required tests for money-touching billing changes) and builds a phase table for tasks with 3+ phases; done closes individual phases or whole tasks with commit references; list shows a status table of all entries. - Use Case: A developer wants to add a new pricing dimension across schema, resolver, snapshot, reports, and UI. They run /todo add, drill the idea with /todo grill-me, split it into five phases with /todo resolve, then close each phase with /todo done NNN phaseN <commit-sha> as implementation sessions complete. ## Quick Start Ask the assistant to record a new idea with the todo skill, for example: add a todo entry for adding a region pricing dimension and then run grill-me on it.

Frequently Asked Questions about todo

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

FAQPage Schema
How do I track ideas and tasks in markdown files with Claude Code?

Use the todo skill's add subcommand to create a numbered file in docs/todo with a generated slug and standard template. Each entry carries a status field (draft, grilled, resolved, done) that you advance with the grill-me, resolve, and done subcommands.

How do I break a large task into phases before implementation?

Run the resolve subcommand on the todo entry. When the task has three or more independent phases, it creates a phase table with planned/in-progress/done statuses, and you close each phase with done NNN phaseN plus a commit reference.

Can this skill replace an issue tracker like Jira or GitHub Issues?

No. It is explicitly a local scratchpad for unformalized ideas and multi-phase plans inside the repository, not an issue tracker. It only writes to docs/todo and never touches business logic, migrations, or source code.

What is the grill-me step in the todo workflow?

Grill-me stress-tests a draft idea by invoking the global grill-me skill, which asks probing questions one at a time. Each question and answer is appended to the file's Drill section, and the status moves from draft to grilled when finished.

When does the todo skill stop and ask for permission?

It stops only for blocking cases: git commits (one permission per commit), changes to billing business rules, money-touching tasks without covering tests, unresolvable requirement conflicts, scope changes invalidating the plan, or unavailable secrets and access.