task-management

Break down plans into subtasks and track progress using beads (bd).

37|12|Updated May 10, 2024
One-click install
npx skills add https://github.com/commontoolsinc/labs --skill task-management-commontoolsinc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: task-management
Source: https://github.com/commontoolsinc/labs/tree/main/.claude/skills/task-management
Command: npx skills add https://github.com/commontoolsinc/labs --skill task-management-commontoolsinc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps orchestrate tasks within a session and across agents by using beads (bd) for subtasks and local todos, reducing mental load and preventing context loss.

Core Features & Use Cases

  • Subtask decomposition: Break down plans into actionable issues with dependencies and track progress.
  • Local todo lists: Use bd quickstart to manage a focused set of tasks, keeping track inside the session or NOTES.md if bd isn't available.
  • Cross-session coordination: Instruct subagents to consult bd and update FOCUS.md so another agent can seamlessly take over.

Quick Start

Start a new task by asking the assistant to "manage tasks for ..." and run bd quickstart; if bd is unavailable, initialize a NOTES.md workflow.

Frequently Asked Questions about task-management

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

FAQPage Schema
How do I break down a project into subtasks and track progress across multiple sessions?

Task management with bd (beads) lets you decompose plans into actionable subtasks with dependencies and track progress within and across sessions. Use bd quickstart to initialize, update FOCUS.md at task start, and instruct subagents to consult bd regularly so work transfers seamlessly between agents.

Can I coordinate tasks across multiple agents and worktrees without losing context?

Yes. This Skill coordinates tasks across agents by using bd for subtasks and local to-do lists, updating FOCUS.md to hand off work, and consulting Linear MCP when available or NOTES.md as fallback, ensuring context persists across session boundaries.

What's the quickest way to set up a focused to-do list for a session?

Run bd quickstart to initialize task management with beads for your current session. If bd is unavailable, initialize NOTES.md as a local to-do workflow to keep track of actionable items within the session.

How does task management reduce mental load when juggling multiple workflows?

Breaking work into subtasks with bd and maintaining local to-do lists removes the burden of holding context in memory. Updating FOCUS.md and instructing subagents to consult bd keeps all participants aligned without duplicated effort.

Do I need Linear or external tools to manage tasks with this Skill?

No. The Skill consults Linear MCP when available but falls back to NOTES.md, so you can manage tasks with just local files and bd if external tools aren't accessible.

Can this Skill track dependencies between subtasks and coordinate work across worktrees?

Yes. The Skill breaks down plans into issues with dependencies and tracks progress across multiple worktrees and sessions, making it suitable for complex workflows where subtasks have prerequisites or parallel tracks.