What problem does it solve?
The file-todos skill standardizes and operationalizes repository-level todo management so that code review feedback, technical debt, and ad-hoc work items are captured, triaged, and completed reliably instead of being lost in PR comments or chat.
Core Features & Use Cases
- Create and standardize todos: Use the provided template and filename conventions to produce consistent markdown todos with YAML frontmatter including status, priority, issue_id, tags, and dependencies.
- Triage and lifecycle management: Move items from pending to ready to complete, update frontmatter, rename files to reflect status changes, and fill Recommended Action and Acceptance Criteria during triage.
- Dependency and work-log tracking: Declare blockers via the dependencies field, check for unblocked items before starting work, and maintain chronological Work Log entries for auditability.
- Integrations: Convert PR comments or review findings into todos, use slash commands for interactive triage, and commit completed items with clear references.
Quick Start
Copy the assets/todo-template.md into the todos/ directory using the next sequential issue id, fill the required sections, set status to pending or ready as appropriate, and commit the new todo.