file-todos

Organize markdown todos with YAML frontmatter and status transitions.

1|Updated Jun 28, 2026
One-click install
npx skills add https://github.com/whmathews15/DEX-Personal-Operating-System --skill file-todos-whmathews15
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-todos
Source: https://github.com/whmathews15/DEX-Personal-Operating-System/tree/main/.claude/plugins/compound-engineering/skills/file-todos
Command: npx skills add https://github.com/whmathews15/DEX-Personal-Operating-System --skill file-todos-whmathews15

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This Skill organizes work items, review feedback, and technical debt into a persistent file-based todo system so teams can track progress outside of temporary chat context.

Core Features & Use Cases

  • Todo Creation: Turn findings, PR comments, and feedback into structured markdown todos with IDs, priorities, and dependencies.
  • Lifecycle Management: Move items through pending, ready, and complete states while keeping filenames and frontmatter in sync.
  • Triage and Planning: Review pending items, choose next actions, and record clear recommended actions for approved work.
  • Work Logging: Maintain a chronological history of actions, commands, and learnings for each task.
  • Use Case: A reviewer finds a performance issue in a pull request, and this Skill converts it into a tracked todo with acceptance criteria, dependency tracking, and an execution log.

Quick Start

Use the file-todos skill to convert a code review finding into a new todo, triage its priority and status, and update its work log as the task progresses.

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 technical debt outside of chat context?

You can track code review feedback and technical debt by converting them into structured markdown todos with YAML frontmatter in a dedicated directory. This persistent file-based system keeps issue IDs, priorities, and status transitions auditable.

What is the best way to organize file-based todos for development work items?

The best way to organize file-based todos is applying a structured lifecycle workflow. You create markdown files with YAML frontmatter, then triage pending items, check dependencies, and transition statuses from pending to ready to complete.

How do I manage task dependencies and status transitions in a markdown todo system?

You manage markdown task dependencies and status transitions by enforcing dependency checks before moving items to ready or complete states. The system keeps filenames and YAML frontmatter synchronized while recording status updates in a chronological work log.

Can I use markdown files with YAML frontmatter to triage and prioritize development tasks?

Yes, you can use markdown files with YAML frontmatter to triage and prioritize development tasks. The workflow supports reviewing pending items, assigning priorities, checking dependencies, and recording recommended actions for approved technical debt or feature requests.

How do I maintain a chronological work log for tracked development tasks?

You maintain a chronological work log by appending actions, commands, and learnings directly to the markdown todo file. This creates an auditable history of progress for each task, ensuring that execution context is preserved alongside the item.

Does file-based todo tracking work without external dependencies or databases?

Yes, file-based todo tracking works entirely without external dependencies or databases. It relies on standard markdown files and YAML frontmatter stored locally, making it a lightweight solution for persistent task management and work logging.