Project Todo Management

VerifiedSafe

Manage project tasks using the `todo.md` file as the source of truth. This skill helps track pending and completed items, maintain a focused list (only the last 10 completed), and ensures continuity across work sessions by always referencing the file.

Sby Skills Guide Bot
ProductivityBeginner
1206/2/2026
Claude Code
#todo-management#task-tracking#markdown#productivity#project-management

Recommended for

Our review

This skill enables an AI agent to manage project tasks using a todo.md file as the persistent source of truth.

Strengths

  • Centralizes task tracking in version-controlled markdown.
  • Easy to read and modify.
  • Works across sessions with a persistent file.
  • Simple checkbox format for intuitive management.

Limitations

  • Requires manual editing of todo.md by the AI.
  • No advanced features such as deadlines, dependencies, or prioritization.
  • Limited to the 10 most recent completed items – no full archive.
When to use it

Use this skill to track pending and completed tasks within a project that uses a todo.md file.

When not to use it

Do not use this skill for complex project management requiring Gantt charts, issue tracking integration, or shared team workflows.

Security analysis

Safe
Quality score95/100

The skill only reads and writes to a local todo.md file. There is no network access, no execution of arbitrary commands, no data exfiltration, and no disabling of safety features. It is purely a task management instruction.

No concerns found

Examples

Show pending tasks
Show me my pending tasks from the todo.md file.
Add a new task
Add a task 'Review documentation' to the todo.md file under Pending.
Mark task complete
Mark the task 'Fix bug #42' as complete in todo.md and update the file.

name: todo-management description: Use this skill when working on project tasks, planning work, or when the user asks about todos. Always use todo.md as the source of truth for project tasks.

Project Todo Management

Manage project tasks using the todo.md file as the source of truth.

When to Use This Skill

  • When starting a work session on this project
  • When the user asks about todos, tasks, or what to work on
  • When completing a task (to mark it done)
  • When adding new work items

Instructions

  1. Always use todo.md as the source of truth for project todos

    • The TodoWrite tool is for tracking progress within a single session
    • The todo.md file persists across sessions and is version-controlled
  2. Showing todos:

    • Read todo.md and display pending items clearly
    • Group by category if applicable
  3. Adding todos:

    • Read todo.md, add the new item under the appropriate "Pending" section
    • Use - [ ] checkbox format for consistency
  4. Completing todos:

    • Find the matching item in Pending section
    • Move it to the Completed section with - [x] format
    • Include any sub-items if applicable
  5. Managing completed items:

    • Keep only the 10 most recent completed items in the Completed section
    • When Completed exceeds 10 items, delete the oldest items
    • No separate archive section - just maintain last 10 completed
    • This keeps the todo.md file focused and scannable
  6. Starting work:

    • Read todo.md, identify the task to work on
    • Create a TodoWrite session list to track progress on that item
    • Begin working on it

Important

When starting any work session on this project, check todo.md first to understand pending work and maintain continuity across sessions.

Related skills