markdown-tasks

Manage markdown task lists in .llm/todo.md via Python CLI commands.

14|4|Updated Oct 20, 2025
One-click install
npx skills add https://github.com/motlin/claude-code-plugins --skill markdown-tasks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-tasks
Source: https://github.com/motlin/claude-code-plugins/tree/main/plugins/markdown-tasks/skills/tasks
Command: npx skills add https://github.com/motlin/claude-code-plugins --skill markdown-tasks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, and includes scripts (resource) components.

What problem does it solve?

Manually managing markdown-based todo lists, extracting tasks, and updating their status can be cumbersome and error-prone, especially in complex projects. This Skill automates the entire lifecycle of your .llm/todo.md files.

Core Features & Use Cases

  • Automated Task Extraction: Instantly retrieve the first incomplete task along with all its indented context lines.
  • Smart Task Addition: Add new tasks, including multi-line implementation details, in a single command, preserving indentation and structure.
  • Status Management: Mark tasks as complete ([x]) or in-progress ([>]) with a simple command.
  • Task Archiving: Automatically archive completed task lists to a dated backup file, keeping your active todo.md clean.
  • Use Case: Let the AI automatically fetch your next task, add detailed new tasks, or mark completed items, keeping your project's todo list always up-to-date and actionable without manual file editing.

Quick Start

Get the next incomplete task from the .llm/todo.md file.

Frequently Asked Questions about markdown-tasks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate markdown task list management without manual file editing?

Automate markdown task lists by using Python scripts to extract incomplete tasks, add new items, mark status changes, and archive completed lists in `.llm/todo.md`, preserving indentation and multi-line context automatically.

Can I extract the next incomplete task from a markdown todo file programmatically?

Yes, retrieve the first incomplete task along with all indented context lines from your `.llm/todo.md` file using the supplied Python CLI commands, enabling workflow automation without manual parsing.

How do I add multi-line tasks to a markdown todo list while preserving formatting?

Add new tasks with implementation details in a single command; the Python scripts automatically preserve indentation and structure, maintaining readability in your `.llm/todo.md` file.

What's the best way to keep markdown todo lists organized as projects grow?

Mark tasks as complete or in-progress with simple commands, then automatically archive finished lists to dated backup files, keeping your active `.llm/todo.md` clean and searchable.

Do I need Python installed to manage markdown-based task workflows?

Yes, Python 3 is required to run the supplied scripts that automate task extraction, status updates, and archiving in your `.llm/todo.md` workflow.

Can markdown todo automation integrate with version control workflows?

Yes, the Skill handles `.gitignore` exclude entries for the `.llm` directory, allowing your task lists to remain locally managed without conflicting with your repository's version control.