file-todos

Track code review feedback and technical debt in markdown todo files.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/CuriousCrow123/godot-compound --skill file-todos-curiouscrow123
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-todos
Source: https://github.com/CuriousCrow123/godot-compound/tree/main/skills/file-todos
Command: npx skills add https://github.com/CuriousCrow123/godot-compound --skill file-todos-curiouscrow123

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

The file-based todo system codifies and streamlines how code review feedback, technical debt, and work items are tracked across a todos/ directory, reducing context switching and improving traceability.

Core Features & Use Cases

  • Create, triage, and track todos using markdown files with YAML frontmatter
  • Manage status transitions (pending → ready → complete) and enforce dependencies
  • Integrate todo workflows with slash commands, code reviews, and governance processes

Quick Start

Create a new todo from findings and place it under todos/ with the appropriate status and 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 code review feedback and technical debt using markdown files?

You can track code review feedback and technical debt by creating markdown files with YAML frontmatter inside a todos/ directory. The file-based todo system uses frontmatter to define status, priority, and dependencies, reducing context switching and improving traceability across your team's work logs.

What is the best way to triage file-based todos for a development team?

The best way to triage file-based todos is using a dedicated todos/ directory structure with a reusable template. This system codifies triage workflows by enforcing status transitions from pending to ready to complete, ensuring dependencies are respected and work items are properly prioritized.

Can I enforce todo dependencies and status transitions in a file-based workflow?

Yes, the file-based workflow enforces todo dependencies and status transitions using YAML frontmatter. You can manage state changes from pending to ready to complete, ensuring that development teams respect prerequisite work items before moving tasks forward in the triage process.

How do I integrate a markdown todo system with code reviews and governance processes?

You integrate a markdown todo system with code reviews by creating todo files from review findings and placing them in the todos/ directory. This workflow integrates with slash commands and governance processes to document work logs and triage technical debt systematically.

Does a file-based todo system require YAML frontmatter for work logs?

Yes, the file-based todo system requires YAML frontmatter in markdown files to define status, priority, and dependencies. This structured metadata enables development teams to triage, prioritize, and document work across code reviews and governance processes effectively.

When should I not use a file-based todo system for tracking technical debt?

You should not use a file-based todo system if your development team prefers centralized databases over markdown directories for work logs. This approach specifically suits teams wanting to codify traceability and reduce context switching using a todos/ directory structure with reusable templates.