todo

cerico's avatarfrom cerico

Work through tasks in the project's TODO.md file

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 10, 2026
[Project Management]

When & Why to Use This Skill

This Claude skill automates project workflows by systematically reading, executing, and updating tasks listed in a project's TODO.md file. It enhances developer productivity by transforming static task lists into actionable agentic workflows, ensuring codebase improvements are implemented, verified, and tracked efficiently without manual oversight.

Use Cases

  • Automated Task Execution: Automatically implement feature requests, bug fixes, or refactoring tasks listed in the project's TODO.md, reducing manual coding effort.
  • Project Maintenance and Cleanup: Systematically address technical debt and documentation gaps by letting the agent work through a backlog of minor improvements.
  • Progress Tracking and Reporting: Maintain an up-to-date project status by having the agent automatically check off completed items and provide structured updates on changes made.
  • Onboarding and Initialization: Quickly establish a project roadmap by allowing the agent to generate a TODO.md structure and identify initial codebase improvements.
nametodo
descriptionWork through tasks in the project's TODO.md file

TODO

Read the project's TODO.md file and work through uncompleted tasks.

Instructions

  1. Read TODO.md from the project root
  2. Find the first unchecked task (- [ ])
  3. Work through the task completely
  4. Remove the task from TODO.md when complete
  5. If more tasks exist, ask user if they want to continue to the next one

Task Execution

For each task:

  1. Understand what's being asked
  2. Find the relevant files
  3. Implement the solution
  4. Verify it works (run tests if applicable)
  5. Remove the completed task from TODO.md

If No TODO.md Exists

Create one with a basic structure:

# Project TODO

Tasks for improving this codebase.

## Tasks

- [ ] Review codebase and identify improvements

Then ask the user what tasks they'd like to add.

If All Tasks Complete

Report: "All tasks in TODO.md are complete!"

Output Format

## Working on TODO

**Task:** [task description]

**Status:** [In Progress / Complete]

**Changes:**
- file.ts: [what was done]

**Next:** [X tasks remaining] - Continue? (y/n)