file-todos

Create and manage Markdown todos with YAML frontmatter for code review feedback.

25|15|Updated Aug 2, 2021
One-click install
npx skills add https://github.com/JesusFilm/core --skill file-todos-jesusfilm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-todos
Source: https://github.com/JesusFilm/core/tree/main/.claude/skills/file-todos
Command: npx skills add https://github.com/JesusFilm/core --skill file-todos-jesusfilm

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

The File-Based Todo system provides a lightweight, human-readable way to track feedback, technical debt, and work items directly alongside code, avoiding scattered spreadsheets or ad-hoc notes.

Core Features & Use Cases

  • Frontmatter-based todos: Each item is a Markdown file with YAML frontmatter for status, priority, dependencies, and metadata.
  • Lifecycle workflows: Create new todos, triage, update status through pending, ready, and complete, and log work progress.
  • Dependency management & integration: Link work items to blockers and integrate with code reviews and slash commands.

Quick Start

Create a new todo in the todos/ directory using the provided template and customize its frontmatter and sections.

Frequently Asked Questions about file-todos

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

FAQPage Schema
How do I manage code review feedback and technical debt using markdown files?

Manage markdown file-based todos by creating items in a todos directory using YAML frontmatter to track status, priority, issue IDs, tags, and dependencies. This lightweight system keeps feedback and technical debt tracked directly alongside code.

How do I create a new todo for a code review work item?

Create a new file-based todo by copying the provided markdown template into the todos directory. Customize the YAML frontmatter fields like status, priority, issue_id, tags, and dependencies to fit your specific workflow item.

What is the best way to track dependencies across file-based todos?

Track dependencies across file-based todos by defining them in the YAML frontmatter schema. This allows you to link work items to blockers and manage triage workflows for pending, ready, and complete statuses.

Can I use markdown frontmatter to triage pending work items?

Yes, you can triage pending markdown todo items by updating their YAML frontmatter status fields. The system supports lifecycle workflows that move items through pending, ready, and complete states during software development.

Why use markdown files instead of spreadsheets for tracking technical debt?

Use markdown files for tracking technical debt to maintain a lightweight, human-readable format directly alongside code. This avoids scattered spreadsheets and ad-hoc notes while adhering to a structured YAML frontmatter schema.