Back to Skills

file-todos

This skill should be used when managing the file-based todo tracking system in the todos/ directory. It provides workflows for creating todos, managing status and dependencies, conducting triage, and integrating with slash commands and code review processes.

6,114stars482forksUpdated 1/23/2026

Security Assessment

Safe(100/100)
Security Score100/100

About file-todos

The file-todos skill is designed to manage a file-based todo tracking system within the `todos/` directory, helping users organize and track work items such as code review feedback, technical debt, feature requests, and general work tasks. It provides a structured framework to ensure todos are created, updated, and tracked with consistent and clear workflows. The skill addresses the need for efficient task management within software development projects by offering a streamlined method for managing complex tasks, dependencies, and approvals across teams.

FAQ

How do I create a new todo?

To create a new todo, you should determine the next issue ID, copy the todo template, and fill out the required sections including problem statement, findings, proposed solutions, and acceptance criteria. Then, decide if the status should be 'pending' or 'ready'.

What should be included in the todo file?

Each todo file should include a YAML frontmatter section with the status, priority, issue ID, tags, and dependencies. The markdown file must also contain sections like Problem Statement, Findings, Proposed Solutions, Recommended Action, Acceptance Criteria, and a Work Log.

Can I modify the status of a todo?

Yes, the status of a todo can be updated. When triaging pending items, you can approve a todo by renaming the file and changing the status from 'pending' to 'ready'.

Install file-todos

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill