Where are the tasks stored?

All tasks are stored as Markdown files within a dedicated todos/ directory in your repository, making them version-controlled and accessible to all team members.

Can I use this with existing project management tools?

Yes, it can supplement external tools by providing a lightweight, git-persistent way to track granular technical tasks and findings directly alongside the source code.

Does it support priority levels?

Yes, it uses a standardized p1 (critical), p2 (important), and p3 (nice-to-have) priority system to help you focus on the most impactful work.

How are dependencies managed between todos?

Tasks use YAML frontmatter to list issue IDs they are blocked by, allowing the skill to programmatically check which tasks are ready for implementation.

How does this differ from standard TODO comments in code?

Unlike simple code comments, this skill creates standalone Markdown files with rich metadata (priority, status, dependencies) and detailed work logs for better organization and long-term tracking.

File-Based Todo Manager

Name: File-Based Todo Manager
Author: Activer007

byActiver007

0•

Productivity & Workflow

Manages a structured, repository-level task tracking system using Markdown files and YAML metadata for seamless project management.

The File-Based Todo Manager skill allows Claude to maintain a robust, git-persisted issue tracking system directly within your project's todos/ directory. It provides specialized workflows for capturing code review feedback, managing technical debt, and tracking feature requests through standardized Markdown files. By utilizing YAML frontmatter for status, priority, and dependency tracking, this skill bridges the gap between ad-hoc code comments and heavy project management software, ensuring that every task has a clear problem statement, findings, and a chronological work log.

Key Features

01Integrated work logs for maintaining a historical record of investigation and actions.

02Comprehensive dependency tracking to identify blocked tasks and unblocked work.

030 GitHub stars

04Built-in triage workflows to move items from pending to ready or complete status.

05Seamless integration with code reviews and PR resolution processes.

06Standardized file-naming and YAML frontmatter for automated task sorting and filtering.

Use Cases

01Documenting and prioritizing technical debt discovered during development sessions.

02Converting complex code review feedback into actionable, tracked work items.

03Managing multi-step refactoring projects with research findings and proposed solutions.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

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

For use in Claude.ai and ChatGPT

Download Skill