file-todos

Manage todos in markdown files with YAML frontmatter.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/apollostreetcompany/codex-compound --skill file-todos-apollostreetcompany
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-todos
Source: https://github.com/apollostreetcompany/codex-compound/tree/main/plugins/compound-engineering/skills/file-todos
Command: npx skills add https://github.com/apollostreetcompany/codex-compound --skill file-todos-apollostreetcompany

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This skill provides a streamlined way to manage todos through a file-based tracking system, making it easier to organize and prioritize tasks.

Core Features & Use Cases

  • File-Based Todo Tracking: Manage todos with markdown files, supporting a structured format for issues, solutions, and work logs.
  • Lifecycle Management: Track todos from creation to completion with clear status and priority markings.
  • Integration with Workflows: Seamlessly integrate with code review processes, PR comments, and slash commands.
  • Use Case: For instance, when you receive feedback on a PR, you can quickly create a todo file to address the issue, set its priority, and track its progress through to completion.

Quick Start

Create a new todo for a bug fix by running the command: file-todos create "Bug fix in XYZ module" --priority p1 --status pending

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 feedback and PR comments using markdown files?

Markdown todo tracking uses files with YAML frontmatter to manage task lifecycles from creation to completion. It provides a structured format for logging issues, setting priorities, and tracking work progress within your development environment.

What is the best way to manage task lifecycles for bug fixes within a team?

You can create a new todo for a bug fix by running a command with the task description, priority, and status. This generates a markdown file with YAML frontmatter to track the issue through its lifecycle until completion.

Can I integrate file-based todo management with my existing code review workflows?

Yes, file-based todo management integrates seamlessly with code review processes and PR comments. You can quickly create todo files to address feedback, set priorities, and track progress using slash commands within your workflow.

Does file-todos require any external dependencies to manage markdown todos?

No external dependencies are required to manage markdown todos. The system operates independently using markdown files with YAML frontmatter, utilizing scripts and references to handle creation, triaging, and completion of tasks.

How do I create a high-priority todo for a pending issue?

Run the create command with your task description, setting the priority to p1 and status to pending. This generates a structured markdown file with YAML frontmatter to document the issue and track its progress until completion.