file-todos

Create and manage markdown todos with YAML frontmatter in the todos/ directory.

2|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/CristoVentures/LocalCents --skill file-todos-cristoventures
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: file-todos
Source: https://github.com/CristoVentures/LocalCents/tree/main/.agent/skills/file-todos
Command: npx skills add https://github.com/CristoVentures/LocalCents --skill file-todos-cristoventures

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This skill provides structured workflows for managing the file-based todo tracking system in the todos/ directory, enabling consistent creation, status management, dependency tracking, triage, and integration with slash commands and code review processes.

Core Features & Use Cases

  • Todo files follow a naming convention: {issue_id}-{status}-{priority}-{description}.md to organize work items clearly.
  • Lifecycle support: pending → ready → complete, with triage and dependency tracking to coordinate work.
  • Triaging and work logging: convert findings into todos, update status, and log progress and decisions.
  • Integration with development workflows: tie todo actions to code reviews, PR comments, and planning discussions for better traceability.

Quick Start

Create a new todo in the todos/ directory using the naming convention and fill in the required sections.

Frequently Asked Questions about file-todos

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

FAQPage Schema
How do I track markdown todos for code review findings and technical debt?▼

To track markdown todos for code reviews, you create structured files in the todos/ directory using a YAML frontmatter schema to capture status, priority, issue_id, tags, and dependencies for each work item.

What is the best way to manage feature request status and dependencies in markdown files?▼

The best way to manage feature request status in markdown is enforcing a structured YAML frontmatter schema and a naming convention to track the lifecycle from pending to ready to complete.

How does file-based todo tracking integrate with project management workflows?▼

File-based todo tracking integrates with project management workflows by tying todo actions to code reviews, PR comments, and planning discussions, providing clear traceability for triage and progress logging.

Can I use markdown todo files to coordinate work items requiring dependency tracking?▼

Yes, you can coordinate work items requiring dependency tracking by defining relationships in the YAML frontmatter schema of each markdown todo file to ensure correct execution order.

What naming convention should I follow when creating a markdown todo for triage?▼

When creating a markdown todo for triage, you should follow the {issue_id}-{status}-{priority}-{description}.md naming convention to organize work items clearly inside the todos/ directory.

Do I need a specific tool to enforce the YAML frontmatter schema for markdown todos?▼

No specific external tool is required; the skill itself prescribes the structured template and enforces the YAML frontmatter schema to maintain consistency across your file-based todo tracking system.