Stats
Actions
Tags
From product-design
Lists tasks from directories like focus/active/paused/completed by parsing Markdown files for progress, status, priority, estimates, and dependencies. Filters by status/dir; outputs table/list/JSON with aggregates.
How this skill is triggered — by the user, by Claude, or both
Slash command
/product-design:task-listThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
**Category**: Task Management
Category: Task Management
task-list [--dir <directory>] [--status <status>] [--format <format>]
--dir: Optional - Specific directory (focus, active, paused, completed, all). Default: all--status: Optional - Filter by status (pending, in_progress, completed, blocked)--format: Optional - Output format (table, list, json). Default: tableWhen this command is run, Claude Code should:
📋 Task List Overview
FOCUS (1 task)
ID | Title | Progress | Est/Act | Priority | Status
----------|----------------------------|----------|---------|----------|------------
TASK-001 | User Authentication | 50% | 8h/4h | 🔴 High | In Progress
ACTIVE (3 tasks)
ID | Title | Progress | Est/Act | Priority | Status
----------|----------------------------|----------|---------|----------|------------
TASK-002 | API Documentation | 0% | 4h/0h | 🟡 Med | Pending
TASK-003 | Search Implementation | 20% | 12h/2h | 🔴 High | In Progress
TASK-004 | Performance Optimization | 0% | 6h/0h | 🟢 Low | Blocked ⚠️
PAUSED (1 task)
ID | Title | Progress | Est/Act | Priority | Reason
----------|----------------------------|----------|---------|----------|------------
TASK-005 | Data Migration | 30% | 10h/3h | 🟡 Med | Waiting for DB
Summary: 5 tasks | 2 in progress | 1 blocked | Total: 40h estimated, 9h actual
📋 Task List
🎯 FOCUS
└── TASK-001: User Authentication
Progress: 50% | 8h estimated, 4h actual | High priority
Status: In Progress | Next: 2.3 Implement JWT tokens
📂 ACTIVE (3)
├── TASK-002: API Documentation
│ Progress: 0% | 4h estimated | Medium priority
│ Status: Pending | Dependencies: TASK-001
│
├── TASK-003: Search Implementation
│ Progress: 20% | 12h estimated, 2h actual | High priority
│ Status: In Progress
│
└── TASK-004: Performance Optimization
Progress: 0% | 6h estimated | Low priority
Status: Blocked ⚠️ | Reason: Waiting for profiling tools
{
"summary": {
"total_tasks": 5,
"in_progress": 2,
"blocked": 1,
"total_estimated_hours": 40,
"total_actual_hours": 9
},
"tasks": {
"focus": [...],
"active": [...],
"paused": [...],
"completed": [...]
}
}
████████░░ - Visual progress bartask-system-init# List all tasks
task-list
# Show only focused task
task-list --dir focus
# Show all in-progress tasks
task-list --status in_progress
# Get JSON for automation
task-list --format json > tasks.json
# Show only active directory in list format
task-list --dir active --format list
npx claudepluginhub jpoutrin/product-forge --plugin product-designDefines conventions for TASKS.md files: structure with optional sections, status symbols ([ ] todo, [/] ongoing, [x] done, [-] backlog), task descriptions, and testable acceptance criteria. Use for creating, editing, updating tasks or tracking progress.
Displays progress on incomplete task lists from .plans/tasks-*.yml files: total/completed counts, next actionable task per feature. Use to check active feature status.
Lists tasks from Markdown files with YAML frontmatter in 'tasks' directory or custom path, applies filters like --status, --priority, --tags, --owner, displays formatted table.