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.