file-todos

Manage file-based todos with markdown and YAML frontmatter.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This Skill streamlines project task management by providing a robust system for creating, triaging, and tracking todos using markdown files, ensuring clarity and accountability.

Core Features & Use Cases

  • Todo Creation: Generate new todos from findings, feedback, or code.
  • Lifecycle Management: Track todos from pending to ready to complete.
  • Dependency Tracking: Define and manage inter-task dependencies.
  • Triage & Prioritization: Facilitate review and approval of pending tasks.
  • Work Logging: Maintain a chronological record of actions and learnings.
  • Use Case: When a code review uncovers a potential bug, create a new todo file, define its priority and acceptance criteria, and then triage it for the team to address.

Quick Start

Use the file-todos skill to create a new todo file for a critical bug fix.

Frequently Asked Questions about file-todos

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

FAQPage Schema
How do I manage project todos using markdown files?

You can manage project todos using markdown files with YAML frontmatter by creating files in a 'todos/' directory. This system supports task status management, priority assignment, and dependency tracking to ensure project clarity and accountability.

What is the best way to track task dependencies in a file-based workflow?

Tracking task dependencies in a file-based workflow is handled by defining inter-task relationships directly within markdown todo files. This allows you to manage lifecycle states from pending to ready and complete while maintaining clear task hierarchies.

How do I triage pending tasks from code review findings?

Triage pending tasks from code review findings by generating new markdown todo files that capture the feedback. You can define priority levels and acceptance criteria, then review and approve these pending tasks for the team to address.

Can I log chronological work history and actions within markdown task files?

Logging chronological work history and actions within markdown task files is fully supported. You can maintain a detailed record of actions and learnings directly in the todo file to track progress over time.

Does this markdown task management system integrate with development workflows?

This markdown task management system integrates directly with development workflows via slash commands and code review processes. It allows you to seamlessly generate new todos from findings, feedback, or code.

When should I not use a markdown-based todo system for project management?

You should avoid a markdown-based todo system for project management if your workflow requires real-time multi-user concurrent editing or complex graphical Kanban boards, as this system relies entirely on file-based markdown tracking.