file-todos

Manage development tasks and code review feedback in markdown files with YAML frontmatter.

Updated Aug 23, 2026

Search Tags:#workflow #markdown #task management #dependencies #issue tracking #todo

Ready to run

npx skills add https://github.com/adamfeldman/compound-workflows --skill file-todos-adamfeldman

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: file-todos
Source: https://github.com/adamfeldman/compound-workflows/tree/main/plugins/compound-workflows/skills/file-todos
Command: npx skills add https://github.com/adamfeldman/compound-workflows --skill file-todos-adamfeldman

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This Skill provides a robust, file-based system for managing tasks, feedback, and technical debt directly within markdown files, ensuring all work items are tracked, prioritized, and their lifecycle is managed.

Core Features & Use Cases

Todo Creation: Easily create new todo items from findings, feedback, or code comments.
Lifecycle Management: Track todos through pending, ready, and complete statuses.
Dependency Tracking: Define and manage dependencies between different todo items.
Use Case: Convert a complex piece of code review feedback into a pending todo, triage it to ready with a clear action plan, and track its progress through work log entries until completion.

Quick Start

Create a new todo item for fixing a critical bug with high priority.

Frequently Asked Questions about file-todos

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

FAQPage Schema

How do I track development tasks and technical debt in markdown files?▼

To track development tasks in markdown files, you can use a file-based system with YAML frontmatter to manage todo creation, status updates, and priority assignment directly within your repository.

Can I manage task dependencies using markdown for issue tracking?▼

Yes, you can manage task dependencies using markdown issue tracking by defining relationships between todo items in YAML frontmatter to ensure proper execution order.

What is the best way to convert code review feedback into actionable todos?▼

The best way to convert code review feedback into actionable todos is to create a pending markdown todo item, triage it to ready with an action plan, and track progress through work log entries.

How do task statuses like pending, ready, and complete work in markdown todo management?▼

In markdown todo management, task statuses like pending, ready, and complete define the lifecycle of an item, allowing you to track work from initial creation through triage to final completion.

Does this markdown task management approach integrate with PR comments and development workflows?▼

Yes, this markdown task management approach integrates with development workflows to capture PR comments and code review feedback, converting them directly into tracked technical debt items.

What are the limitations of using a file-based system for tracking technical debt?▼

A limitation of using a file-based system for tracking technical debt is that it lacks a centralized database, meaning dependency resolution and cross-repository task tracking require manual file management.