task-list-md

Parse and manage hierarchical Markdown task lists with a Python CLI.

1|Updated Oct 26, 2025
One-click install
npx skills add https://github.com/gosu-code/claude-plugin --skill task-list-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: task-list-md
Source: https://github.com/gosu-code/claude-plugin/tree/main/plugins/gosu-mcp-core/skills/task-list-md
Command: npx skills add https://github.com/gosu-code/claude-plugin --skill task-list-md

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Managing tasks stored in Markdown files, including statuses, dependencies, and hierarchy, without leaving your editor.

Core Features & Use Cases

  • Parse and organize hierarchical tasks from Markdown checklists (using - [ ], - [x], etc.) and maintain status history.
  • Track progress with per-task metadata and a persistent .tasks.local.json store across edits.
  • Provide quick operations for listing, viewing, updating statuses, and resolving ready-to-work tasks in project docs.

Quick Start

Run the task-list-md CLI on a Markdown file to manage and track your tasks.

Frequently Asked Questions about task-list-md

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

FAQPage Schema
How do I track hierarchical Markdown tasks without leaving my editor?

You can track hierarchical Markdown tasks by running a Python CLI that parses checklists and stores progress in a local JSON file. This allows you to manage statuses and dependencies directly within your project documentation.

Can I manage task dependencies in a Markdown checklist?

Yes, you can manage task dependencies in a Markdown checklist using a dedicated CLI. The tool parses hierarchical lists and tracks task readiness, ensuring you only work on items with completed prerequisites.

How do I update the status of a subtask in a Markdown to-do list?

To update a subtask status in a Markdown to-do list, use the set-status CLI command. This modifies the checklist item and records the change in a persistent .tasks.local.json state file for continuous progress tracking.

What is the best way to find the next ready-to-work task in project docs?

The best way to find the next ready-to-work task is using the get-next-task CLI command. It analyzes your Markdown task hierarchy and dependencies to resolve and surface only the items that are currently ready for execution.

Does this Markdown task management tool require external databases?

No, this Markdown task management tool does not require external databases. It relies on a local Python script and persists all task metadata, statuses, and dependency history in a lightweight .tasks.local.json file.

What Markdown syntax is supported for project task tracking?

Standard checklist syntax using - [ ] and - [x] is supported for project task tracking. The parser reads these Markdown markers to identify subtasks, update their completion status, and maintain the overall hierarchy.