How do I install the Markdown Tasks skill?

Run npx skillmds add majiayu000/markdown-tasks in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Markdown Tasks safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Markdown Tasks?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Markdown Tasks free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Markdown Tasks?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Markdown Tasks by majiayu000 — Agent Skill

Name: Markdown Tasks
Rating: 4.5 (4 reviews)
Author: majiayu000

Markdown Tasks

Work with markdown-based task lists in .llm/todo.md files. Use when managing tasks, working with todo lists, extracting incomplete tasks, marking tasks complete, or implementing tasks from a task list.

majiayu000 ac3f9cb 2 files · 3.3 KB Updated Sep 9, 2026 567 repo stars

File contents

Markdown Task Management

This skill enables working with the markdown task list stored in .llm/todo.md.

Scripts

task_get.py - Extract Next Task

Extract the first incomplete task with its context:

python ${CLAUDE_PLUGIN_ROOT}/scripts/task_get.py .llm/todo.md

Returns the first [ ] checkbox line with all indented context lines below it.

Exit codes: 0 (success), 1 (file not found or error)

task_add.py - Add New Task

Add a new task:

python ${CLAUDE_PLUGIN_ROOT}/scripts/task_add.py .llm/todo.md "Task description
  Context line 1
  Context line 2"

Creates the .llm/ directory and todo.md file if they do not exist, and appends the new task with a [ ] checkbox. The script preserves all indentation in multi-line strings.

Exit codes: 0 (success), 1 (error)

task_complete.py - Mark Task Done

Mark the first incomplete task as done:

python ${CLAUDE_PLUGIN_ROOT}/scripts/task_complete.py .llm/todo.md

Changes the first [ ] to [x].

Exit codes: 0 (success), 1 (no incomplete tasks or error)

task_archive.py - Archive Task List

Archive a completed task list:

python ${CLAUDE_PLUGIN_ROOT}/scripts/task_archive.py .llm/todo.md

Moves the file to .llm/YYYY-MM-DD-todo.md where YYYY-MM-DD is today's date.

Exit codes: 0 (success), 1 (file not found or error)

Task Format

The task list is in .llm/todo.md.

NEVER use the Read tool on .llm/todo.md. Always interact with the task list exclusively through the Python scripts.

Task States

[ ] - Not started (ready to work on)
[x] - Completed
[!] - Blocked after failed attempt

Task Structure

Each task includes indented context lines with full implementation details:

Absolute file paths
Exact function/class names
Code analogies to existing patterns
Dependencies and prerequisites
Expected outcomes

Standalone Context

Each task is extracted and executed in isolation. Every task must contain ALL context needed to implement it. Repeat shared context in every related task. Never reference other tasks.

If tasks were created from a plan file (e.g., from planning mode), include the plan file path in each task so the implementing agent can read the full context.

---name: markdown-tasksdescription: Work with markdown-based task lists in .llm/todo.md files. Use when managing tasks, working with todo lists, extracting incomplete tasks, marking tasks complete, or implementing tasks from a task list.--- # Markdown Task Management This skill enables working with the markdown task list stored in `.llm/todo.md`. ## Scripts ### task_get.py - Extract Next Task Extract the first incomplete task with its context: ```bash python ${CLAUDE_PLUGIN_ROOT}/scripts/task_get.py .llm/todo.md ``` Returns the first `[ ]` checkbox line with all indented context lines below it. **Exit codes**: 0 (success), 1 (file not found or error) ### task_add.py - Add New Task Add a new task: ```bash python ${CLAUDE_PLUGIN_ROOT}/scripts/task_add.py .llm/todo.md "Task description Context line 1 Context line 2" ``` Creates the `.llm/` directory and `todo.md` file if they do not exist, and appends the new task with a `[ ]` checkbox. The script preserves all indentation in multi-line strings. **Exit codes**: 0 (success), 1 (error) ### task_complete.py - Mark Task Done Mark the first incomplete task as done: ```bash python ${CLAUDE_PLUGIN_ROOT}/scripts/task_complete.py .llm/todo.md ``` Changes the first `[ ]` to `[x]`. **Exit codes**: 0 (success), 1 (no incomplete tasks or error) ### task_archive.py - Archive Task List Archive a completed task list: ```bash python ${CLAUDE_PLUGIN_ROOT}/scripts/task_archive.py .llm/todo.md ``` Moves the file to `.llm/YYYY-MM-DD-todo.md` where YYYY-MM-DD is today's date. **Exit codes**: 0 (success), 1 (file not found or error) ## Task Format The task list is in `.llm/todo.md`. NEVER use the `Read` tool on `.llm/todo.md`. Always interact with the task list exclusively through the Python scripts. ### Task States - `[ ]` - Not started (ready to work on) - `[x]` - Completed - `[!]` - Blocked after failed attempt ### Task Structure Each task includes indented context lines with full implementation details: - Absolute file paths - Exact function/class names - Code analogies to existing patterns - Dependencies and prerequisites - Expected outcomes ### Standalone Context Each task is extracted and executed in isolation. Every task must contain ALL context needed to implement it. Repeat shared context in every related task. Never reference other tasks. If tasks were created from a plan file (e.g., from planning mode), include the plan file path in each task so the implementing agent can read the full context.

Frequently asked questions