How does this differ from the standard TaskCreate tool?

Standard TaskCreate tools are usually in-memory and temporary for a single session. This skill persists tasks to disk, allowing them to survive across different conversations and AI restarts.

Where are the todo files stored?

All todos are stored as structured markdown files within the .claude/todos/ directory of your project repository.

Does it support task priorities?

Yes, it uses a standardized p1 (critical), p2 (important), and p3 (nice-to-have) priority system reflected in both filenames and metadata.

Can I use this skill with my human team members?

Yes. Because the todos are file-based and committed to your repository, they serve as a shared source of truth that both humans and AI agents can read and update.

How are task dependencies handled?

Tasks are assigned sequential IDs. You can list these IDs in the 'dependencies' field of a todo's YAML frontmatter to indicate which tasks must be completed first.

File-Based Todo Manager

Name: File-Based Todo Manager
Author: jayteealao

byjayteealao

0•

Herramientas de Colaboración

Manages a structured, file-based task tracking system within your repository to organize code reviews, technical debt, and feature requests.

The File-Based Todo Manager skill provides a robust framework for managing the development lifecycle directly within your codebase via the .claude/todos/ directory. It enables Claude to create, triage, and execute tasks using a standardized markdown format complete with YAML frontmatter for metadata. By enforcing naming conventions and structured sections like Problem Statements, Work Logs, and Acceptance Criteria, this skill ensures that project context and progress are persisted across multiple AI sessions and remain easily accessible to human collaborators for long-term project management.

Características Principales

01Standardized markdown todo creation with YAML frontmatter metadata

020 GitHub stars

03Automated triage workflow for pending, ready, and complete statuses

04Chronological work logging for historical record and context sharing

05Advanced dependency tracking between tasks using unique issue IDs

06Searchable task repository using tags, priorities, and full-text grep

Casos de Uso

01Converting code review findings into actionable and tracked work items

02Maintaining a transparent, version-controlled technical debt log within the repository

03Managing complex refactors with multi-task dependencies across AI sessions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jayteealao/agent-skills file-todos

For use in Claude.ai and ChatGPT

Download Skill