# Taskmaster Skill

> Use when managing complex project plans, tracking multi-phase task progress, or prioritizing development tasks

- **Type:** Skill
- **Install:** `agentstack add skill-dqz00116-skill-lib-taskmaster-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Dqz00116](https://agentstack.voostack.com/s/dqz00116)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Dqz00116](https://github.com/Dqz00116)
- **Source:** https://github.com/Dqz00116/skill-lib/tree/main/taskmaster-skill

## Install

```sh
agentstack add skill-dqz00116-skill-lib-taskmaster-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# TaskMaster Skill

> Agent-optimized task management system for AgentFabric.

## Overview

A structured task management system for organizing, tracking, and executing multi-phase development plans through agent-optimized CLI workflows.

## When to Use

- Managing complex project plans with interdependent tasks
- Tracking multi-phase task progress across milestones or sprints
- Prioritizing development tasks based on dependencies and readiness
- Coordinating sequential work that requires structured start, verify, and archive workflows

**Do not use when:**
- Simple single-step tasks without dependencies
- Informal tracking where a basic todo list is sufficient
- Projects not requiring configured plan directories or CLI tooling

---

## Setup

### Prerequisites

- Node.js 22+
- Working directory: `docs/plans/`

### Installation

#### Option 1: Direct Node.js (Agent Recommended)

```bash
cd docs/plans/taskmaster-skill/cli
npm install
```

Then use CLI via:
```bash
node cli/task.js 
```

#### Option 2: Shortcut Scripts (Install Dependencies Automatically)

```bash
cd docs/plans

# Windows
taskmaster-skill\task.bat  

# Linux/Mac
./taskmaster-skill/task.sh  
```

### Quick Start

```bash
# View all plans
node cli/task.js plans

# Check progress
node cli/task.js progress mvp_v1

# List tasks
node cli/task.js list mvp_v1

# List ready-to-start tasks (dependencies completed)
node cli/task.js ready mvp_v1
node cli/task.js ready mvp_v1 --limit 20
```

### Configuration (REQUIRED)

**Before using TaskMaster, you MUST configure the plan mapping:**

#### Step 1: Copy template
```bash
cp config.json.template config.json
```

#### Step 2: Edit config.json
```json
{
  "version": "1.0.0",
  "plans": {
    "mvp_v1": {
      "path": "E:\\Agent\\agent-fabric\\docs\\plans\\mvp_v1",
      "description": "AgentFabric MVP v1 实施计划"
    }
  },
  "settings": {
    "defaultPlan": "mvp_v1",
    "autoCreatePlan": false,
    "logRetentionDays": 30
  }
}
```

**Replace the path with your actual plan directory (absolute path).**

#### Step 3: Verify configuration
```bash
# List configured plans
node cli/task.js config list

# Add additional plans if needed
node cli/task.js config add   --description ""

# Set default plan
node cli/task.js config set-default 
```

---

## Documentation Index

### Agent Instruction Manuals

| Document | Purpose | When to Use |
|----------|---------|-------------|
| **[COMMANDS.md](./COMMANDS.md)** | Complete command specifications | Need detailed syntax for any command |
| **[WORKFLOWS.md](./WORKFLOWS.md)** | Standard operation procedures | User asks to start/complete/audit tasks |
| **[BEST_PRACTICES.md](./BEST_PRACTICES.md)** | Operational rules and constraints | Need to validate operation against rules |

### Reference Data

| Document | Purpose | When to Use |
|----------|---------|-------------|
| **[DATA_FORMAT.md](./DATA_FORMAT.md)** | JSON schema specifications | Need to parse or construct data |
| **[TROUBLESHOOTING.md](./TROUBLESHOOTING.md)** | Error codes and resolution procedures | Command returns error |

### Quick Reference

| Document | Purpose | When to Use |
|----------|---------|-------------|
| **[EXAMPLES.md](./EXAMPLES.md)** | Scenario-based execution patterns | User intent matches example scenario |
| **[TEMPLATES.md](./TEMPLATES.md)** | Copy-paste command templates | Need ready-to-use command |

---

## Quick Decision Map

```
User Request
    |
    +-- "查看/查询/了解 (View/Query/Understand)..." ──► Read COMMANDS.md "Query Commands" section
    +-- "有哪些任务可以开始 (What tasks can I start)" ──► Read COMMANDS.md "ready" command
    +-- "开始/做...任务 (Start/Do...task)" ──► Read WORKFLOWS.md "Start Task Workflow"
    +-- "完成/做完了 (Complete/Done)..." ──► Read WORKFLOWS.md "Complete Task Workflow"
    +-- "添加/新建 (Add/Create)...task" ──► Read COMMANDS.md "add" + EXAMPLES.md "Adding New Task"
    +-- "归档 (Archive)..." ──► Verify done + verified ──► Read COMMANDS.md "archive"
    +-- "检查/核验 (Check/Verify)..." ──► Read COMMANDS.md "verify"
    +-- "遇到问题/报错 (Encounter problem/error)..." ──► TROUBLESHOOTING.md
```

---

## Command Syntax

All commands follow this pattern:
```bash
node cli/task.js  [options]
```

Or via shortcut scripts:
```bash
# Windows
taskmaster-skill\task.bat  

# Linux/Mac
./taskmaster-skill/task.sh  
```

## Execution Rules

**ALWAYS:**
1. Check dependencies before `start` (run `deps` first)
2. Verify before `archive` (run `verify` first)
3. Parse command output to determine next action
4. Confirm with user for `--force` operations

**NEVER:**
1. Skip `verify` before `archive` (unless user explicitly confirms `--force`)
2. Assume task ID without confirming
3. Ignore error messages in command output

---

## File Locations

```
docs/plans/
├── taskmaster-skill/
│   ├── cli/task.js        # CLI entry point
│   ├── config.json        # Plan configurations
│   ├── logs/              # Operation logs
│   │   ├── operations.log
│   │   └── operations.jsonl
│   └── *.md               # This documentation
│
└── /
    ├── data.json          # Task data (JSON format)
    └── README.md          # Plan description
```

---

## Version

- CLI Version: 1.1.0
- Data Format: 1.0.0
- Last Updated: 2026-03-04

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Dqz00116](https://github.com/Dqz00116)
- **Source:** [Dqz00116/skill-lib](https://github.com/Dqz00116/skill-lib)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-dqz00116-skill-lib-taskmaster-skill
- Seller: https://agentstack.voostack.com/s/dqz00116
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.