Can I link these todos to GitHub issues?

Yes, the naming convention and frontmatter schema both include fields for GitHub issue numbers and related pull requests for seamless integration.

What are the available commands for this skill?

You can use the /todo command with arguments like list, create, update, and show to manage your task list interactively.

How does the skill handle task dependencies?

The skill uses the 'dependencies' field in the YAML frontmatter to link files. Claude can then check if blocking tasks are completed before marking a dependent task as 'ready'.

Where are the todo files stored?

All todo items are stored as individual Markdown files within the todos/ directory of your project root, allowing them to be versioned with Git.

Why use file-based todos instead of an external tool?

File-based systems ensure your task documentation is version-controlled, works offline, and remains perfectly in sync with the specific branch or version of the code you are working on.

Markdown Todo System

Name: Markdown Todo System
Author: jovermier

byjovermier

生产力与工作流

Manages a persistent, file-based task tracking system using Markdown and YAML frontmatter within your project repository.

关于

The Markdown Todo System skill enables Claude to maintain a structured, version-controlled task management system directly in your codebase. By leveraging markdown files in a dedicated directory with standardized YAML metadata, it allows for sophisticated tracking of task dependencies, priority levels, and detailed work logs. This skill is ideal for developers who want to keep project management closely coupled with their source code, ensuring that todos are trackable, searchable, and integrated into the development lifecycle without requiring external project management software.

主要功能

Automated creation of structured Markdown todo files with YAML frontmatter
Integrated work logging for historical documentation and audit trails within the repo
Standardized status lifecycle management from pending to ready and complete
0 GitHub stars
Priority-based organization using P1 (Critical) to P3 (Nice-to-have) levels
Sophisticated dependency tracking to automatically identify and manage blockers

使用场景

Automating the transition of tasks from pending to ready once all listed dependencies are resolved
Breaking down complex feature requests into actionable, dependent sub-tasks during planning
Maintaining a version-controlled backlog that lives alongside the source code for better context

关于

主要功能

Automated creation of structured Markdown todo files with YAML frontmatter
Integrated work logging for historical documentation and audit trails within the repo
Standardized status lifecycle management from pending to ready and complete
0 GitHub stars
Priority-based organization using P1 (Critical) to P3 (Nice-to-have) levels
Sophisticated dependency tracking to automatically identify and manage blockers

使用场景

Automating the transition of tasks from pending to ready once all listed dependencies are resolved
Breaking down complex feature requests into actionable, dependent sub-tasks during planning
Maintaining a version-controlled backlog that lives alongside the source code for better context