How are task dependencies managed?

Dependencies are tracked via YAML frontmatter using issue IDs. The skill can then grep these files to identify which tasks are blocked or which are ready for immediate action.

When should I create a todo instead of acting immediately?

You should create a todo for tasks requiring more than 20 minutes of work, items needing research or planning, tasks with external dependencies, or work requiring specific approval.

How does this differ from the Rails Todo model?

This skill manages local markdown files in a specific directory for developer workflow and project tracking, whereas a Rails Todo model is typically a database-backed feature for end-users of the application.

Can I customize the todo template?

Yes, the skill is designed to use a template at assets/todo-template.md, allowing you to define the sections and metadata fields that best fit your team's workflow.

File-Based Todo Manager

Name: File-Based Todo Manager
Author: Microck

byMicrock

•

Productivity & Workflow

Manages a structured, file-based task tracking system directly within your repository for seamless developer workflows.

The File-Based Todo Manager skill transforms your project's todos/ directory into a powerful, local task management system. It enables Claude to create, triage, and track the lifecycle of work items—including technical debt, code review feedback, and feature requests—using standardized Markdown files with YAML frontmatter. By integrating task management directly into the codebase, it ensures that project history, dependencies, and work logs are version-controlled alongside your code, facilitating better collaboration and historical context for both human developers and AI agents.

Key Features

01Sophisticated dependency tracking to identify blockers and ready-to-work tasks

02Seamless integration with code reviews and PR resolution processes

03Standardized markdown-based todo creation with YAML frontmatter

04Detailed work logging for historical context and knowledge sharing

05Automated triage workflows for approving and prioritizing pending items

0681 GitHub stars

Use Cases

01Tracking technical debt and refactoring tasks during large-scale code migrations

02Converting complex pull request comments into actionable, tracked work items

03Managing multi-step feature implementation dependencies without leaving the terminal

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add microck/ordinary-claude-skills file-todos

For use in Claude.ai and ChatGPT

Download Skill