Can this skill track dependencies between tasks?

Yes, it utilizes YAML frontmatter to list issue IDs that block a specific todo, ensuring that work is sequenced correctly and blockers are visible.

How is this different from application-level models or temporary task tools?

Unlike app-level models (like a Rails Todo class) or in-memory agent tools, this system creates persistent markdown files on disk specifically for the development team's workflow.

Why use a file-based todo system instead of an external issue tracker?

A file-based system keeps tasks and their historical context directly within the codebase, enabling version control, offline access, and tighter integration with AI-assisted development sessions.

How does the triage workflow work in this skill?

Items are created in a 'pending' state and then promoted to 'ready' through a triage process where a developer or agent assigns priority and defines a recommended action plan.

File-Based Todo Manager

Name: File-Based Todo Manager
Author: jjeremycai

byjjeremycai

0•

Productivity & Workflow

Manages a structured, file-based task tracking system directly within your project repository using markdown and YAML.

This skill implements a robust markdown-based todo system in the todos/ directory, allowing teams to track technical debt, feature requests, and code review feedback alongside their source code. It automates the lifecycle of tasks—from pending triage to completion—using a standardized naming convention, YAML frontmatter for metadata, and detailed work logs. By keeping documentation and tasks local to the codebase, it bridges the gap between high-level project management and granular development activities, ensuring that investigation findings and decision-making processes are never lost.

Key Features

01Command-line filtering by status, priority, and custom tags

020 GitHub stars

03Standardized markdown template with YAML frontmatter for metadata

04Internal dependency tracking to manage blocked work items

05Persistent work logs for historical record and knowledge sharing

06Automated triage workflows for task approval and prioritization

Use Cases

01Documenting technical debt and research findings directly within the repository

02Converting code review findings into actionable, tracked work items

03Managing complex refactoring projects with multiple interlinked dependencies

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jjeremycai/claudekit file-todos

For use in Claude.ai and ChatGPT

Download Skill