file-todos

Create and triage markdown todo files with dependency tracking.

1|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/weorbitant/compound-engineering-feat-python-plugin --skill file-todos-weorbitant
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-todos
Source: https://github.com/weorbitant/compound-engineering-feat-python-plugin/tree/main/skills/file-todos
Command: npx skills add https://github.com/weorbitant/compound-engineering-feat-python-plugin --skill file-todos-weorbitant

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill provides a standardized approach to manage the lifecycle of work items in a project using simple markdown todo files under the todos/ directory, enabling consistent triage, dependency tracking, and integration with slash commands and code review processes.

Core Features & Use Cases

  • Use a structured markdown template to capture problem statements, findings, proposed solutions, acceptance criteria, and work logs.
  • Create, triage, and complete todos with dependency tracking and quick references to related discussions.
  • Integrate with workflow steps and review processes to drive accountability and visibility across teams.

Quick Start

Run the file-todos workflow to create, triage, and close a sample todo using the provided templates.

Frequently Asked Questions about file-todos

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

FAQPage Schema
How do I track todo dependencies in markdown files for development workflows?

Track todo dependencies by modeling each task as a markdown file in a todos/ directory with structured frontmatter. This approach supports creating, triaging, and prioritizing work items while linking related tasks within development workflows.

What's the best way to manage file-based todos for code review processes?

Manage file-based todos using structured markdown templates that capture problem statements, findings, and acceptance criteria. These files integrate with slash commands and code review processes to drive accountability and visibility across teams.

Do I need structured frontmatter to organize markdown todos?

Yes, structured frontmatter is required to organize markdown todos. The system relies on this frontmatter alongside reference templates to standardize triage, dependency tracking, and workflow integration for each task file.

How does slash-command based triage work for markdown todo files?

Slash-command based triage works by executing workflow steps that create, prioritize, and close markdown todo files. These commands operate on structured files in the todos/ directory to maintain consistent task lifecycle management.

Can I use markdown todo files for dependency tracking in software engineering projects?

Yes, you can use markdown todo files for dependency tracking. Each task is modeled as a file in the todos/ directory, enabling you to map dependencies, log work progress, and reference related discussions during development.

When should I not use a markdown-based todo workflow for project triage?

Avoid markdown-based todo workflows if your project requires real-time synchronization or heavy relational data linking beyond simple dependency tracking. This approach uses static files and is best suited for text-driven triage and code review integration.