How are dependencies managed in this skill?

Dependencies are tracked in the YAML frontmatter of each todo file using issue IDs. The skill can then check for blocked items or find which tasks are blocking specific work before execution begins.

How does this differ from standard code TODO comments?

Unlike inline comments, this system uses standalone Markdown files in a dedicated directory. This allows for detailed problem statements, proposed solutions, status tracking, and dependency mapping that is easier to manage and search.

When should I create a todo instead of just fixing the code?

You should create a todo for tasks requiring more than 20 minutes of work, items needing research or approval, or work that has dependencies on other pending tasks.

Can I use this for team collaboration?

Yes. Because the todos are stored as files in your repository, they are version-controlled via Git. This allows team members to see, update, and review the same work items using standard development workflows.

File-Based Todo Tracking

Name: File-Based Todo Tracking
Author: gvkhosla

bygvkhosla

•

生产力与工作流

Manages code review feedback, technical debt, and feature requests through a structured, file-based todo system in your repository.

The File-Based Todo Tracking skill provides a robust framework for managing engineering tasks directly within your project's file system. By using Markdown files with YAML frontmatter, it allows Claude to create, triage, and track the lifecycle of work items—from initial findings to completion. It is specifically designed for complex tasks that require research, planning, or dependency management, ensuring that technical context and decision-making history are preserved in git alongside the source code.

主要功能

01Detailed work logging to maintain a chronological record of actions, investigations, and learnings

0235 GitHub stars

03Seamless integration with code review workflows and pull request feedback loops

04Built-in dependency management to track blocked and blocking tasks across the project

05Automated issue ID generation and status-based naming conventions (pending, ready, complete)

06Standardized Markdown templates with YAML frontmatter for rich metadata tracking

使用场景

01Converting complex code review findings into actionable, tracked work items during a development session

02Managing long-term technical debt and refactoring projects that span multiple agent sessions or days

03Conducting interactive triage of project items to prioritize critical fixes and define recommended actions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add gvkhosla/compound-engineering-pi file-todos

For use in Claude.ai and ChatGPT

Download Skill