task-management

Manage software tasks as Markdown files with YAML frontmatter using the dot CLI.

Updated Jul 1, 2026
One-click install
npx skills add https://github.com/jwilger/claude-code-plugins --skill task-management-jwilger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: task-management
Source: https://github.com/jwilger/claude-code-plugins/tree/main/sdlc/skills/task-management
Command: npx skills add https://github.com/jwilger/claude-code-plugins --skill task-management-jwilger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies organizing software work by modeling tasks as Markdown files stored under a local .dots/ repository, all tracked and orchestrated with the dot CLI. It enables clear structure for stories, epics, blocking dependencies, and priority-based work without external task trackers.

Core Features & Use Cases

  • Markdown-based tasks: Rich task bodies hold context, acceptance criteria, and done criteria.
  • Hierarchical planning: Create epics, break down into stories, and link blockers for precise workflows.
  • Query and track: See ready-to-work tasks, blocked items, and progress across a project.
  • Use Case: A developer maintains a small feature set in .dots/ with epic -> stories -> tasks, then uses dot ready and dot off to update status.

Quick Start

Install and ensure the dot CLI is available, then initialize your workspace and add sample tasks: dot init EPIC_ID=$(dot add "Epic: Sample Project" -p 1 | grep -oP 'Created task: \K[^\s]+') dot add "Implement authentication" -P "$EPIC_ID" -p 2 dot add "Design user onboarding" -P "$EPIC_ID" -p 2 dot tree "$EPIC_ID"

Frequently Asked Questions about task-management

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

FAQPage Schema
How do I manage software epics and stories using Markdown files?

You can manage software epics and stories using Markdown files by storing them in a local .dots/ repository. Markdown bodies hold context and acceptance criteria, while YAML frontmatter tracks status, priority, and hierarchical relationships.

What is the best way to track blocking dependencies for local development tasks?

Tracking blocking dependencies for local development tasks is done by linking blockers within the Markdown task files. You can query ready-to-work items and visualize blocked progress across your project using the dot CLI.

How do I structure priority-driven work for a software project without an external task tracker?

Priority-driven work is structured by assigning priority values in YAML frontmatter. You can create epics, break them into stories, and use CLI commands like dot ready to query available tasks based on their priority.

Do I need the dot CLI installed locally to organize project work in Markdown?

Yes, the dot CLI must be installed locally to organize project work in Markdown. It orchestrates the local .dots/ repository, handling task creation, hierarchical linking, and status updates for your development workflow.

Can I use Markdown task management for both personal productivity and team SDLC workflows?

Markdown task management supports both personal productivity and team SDLC workflows. It models tasks hierarchically from epics to stories, allowing developers to track blockers and update task status locally.

How do I initialize a workspace and add a sample epic with stories using the dot CLI?

Initialize a workspace with dot init, then add an epic using dot add with a priority flag. Capture the returned epic ID and pass it to subsequent dot add commands with the parent flag to generate linked stories.