file-todos

Create and track code-review todos with YAML frontmatter in a todos/ directory.

Updated Jan 21, 2026
One-click install
npx skills add https://github.com/ollieb89/orchestrator --skill file-todos-ollieb89
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-todos
Source: https://github.com/ollieb89/orchestrator/tree/main/.cursor/skills/file-todos
Command: npx skills add https://github.com/ollieb89/orchestrator --skill file-todos-ollieb89

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Efficiently manage code-review feedback, technical debt, and feature work using a lightweight, file-based todo system stored under the todos/ directory. It provides a consistent structure for todos, lifecycle states, and triage workflows without requiring a database or external services.

Core Features & Use Cases

  • Markdown todo files with YAML frontmatter enable easy search, filtering, and human-readable history.
  • Standardized lifecycle (pending → ready → complete) and dependencies for coordination across work items.
  • Templates and reference materials in assets/, including a TODO template, to accelerate creation and documentation.
  • Supports integration with slash commands, code reviews, and triage workflows to streamline team processes.

Quick Start

Create a new todo using the template in assets and begin tracking work in the todos/ directory.

Frequently Asked Questions about file-todos

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

FAQPage Schema
How do I track code review todos using markdown files?

You track code review todos by creating markdown files with YAML frontmatter in the todos/ directory. This file-based system uses a defined lifecycle of pending, ready, and complete states to manage work items without external databases.

What is the best way to manage technical debt and feature requests without a database?

A file-based todo system using markdown and YAML frontmatter is an effective way to manage technical debt and feature requests. It stores items in the todos/ directory, enabling easy search, filtering, and human-readable history without external services.

How do I triage code review feedback in a project management workflow?

You triage code review feedback by creating structured todo files with YAML frontmatter that define identifiers and status. The system supports a standard workflow and lifecycle states to coordinate dependencies across work items.

Can I use slash commands to create markdown todos for my project?

Yes, the file-based todo system supports integration with slash commands and triage workflows. You can use provided templates in the assets/ directory to accelerate the creation of structured markdown todo files.

Does this file-based todo system require any external dependencies or services?

No, the file-based todo system relies entirely on markdown files with YAML frontmatter stored in the todos/ directory. It requires no databases or external services, using only local assets for templates and reference materials.