About managing-tasks
A task-management workflow for agents that hands work across sessions using persistent task files in a repository. It covers creating, executing, triaging, updating, and archiving tasks, with on-disk plans and status as the runtime source of truth.
Key features
- 01Persist task plans and status across sessions
- 02Create one or multiple tasks
- 03Execute tasks and verify completion
- 04Review status and task readiness
- 05Update, block, or cancel tasks
- 06Auto-archive completed or cancelled tasks
Use cases
- 01Resume unfinished work across sessions
- 02Break work into multiple tasks
- 03Check task status and dependencies
- 04Block, revise, or cancel a plan
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/managing-tasksin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
agents/openai.yamlassets/index.mdplan.mdstatus.mdassets/agents/task-implementer.mdtask-planner.mdtask-triager.mdreferences/blocking-task.mdcancelling-task.mdcreating-multiple-tasks.mdcreating-task-agents.mdcreating-task.mdexecuting-multiple-tasks.mdexecuting-task.mdfinding-task-agents.mdtask-contract.mdtriaging-tasks.mdupdating-task.mdDetails
From the project READMEManaging Tasks
Overview
Durable task folders (plan.md, status.md) for cross-session agent handoff. Recipes own action rules; assets/ are copy skeletons; task-contract.md is system plumbing; on-disk plans/status are runtime truth after create.
Agent workflow
Follow this skill for every task-lifecycle action under <tasks-root>/NNN-slug/. Works wherever the agent can read and write repository files.
Tasks root: Locate via <tasks-root>/index.md with the static Author signature UUID. If none exists, ask the user for an empty folder path, then initialize. See task-contract.md → Resolve tasks root.
Statuses: Not Started, In Progress, Blocked, Done, Cancelled. Verify-only remaining keeps In Progress with next_step_id: verify. Done and Cancelled auto-move to archives/.
Match one Recipes row; open exactly that reference.
Recipes
| Intent | Example phrasing | Read |
|---|---|---|
| Create | "Create a task: …", "Plan … as a task", "new task" | creating-task.md |
| Create multiple | "Create tasks for …", "Plan tasks: …", "break this into tasks" | creating-multiple-tasks.md |
| Execute | "Continue tasks/001-…", "Resume the dark mode task", "implement next step", "verify / mark done" | executing-task.md |
| Execute multiple | "Finish all tasks", "run the backlog", "implement until no task available", @-mention tasks root with no folder | executing-multiple-tasks.md |
| Triage / check | "Status of tasks/003-…", "list all tasks", "What can I start?", "What's unblocked?", "roadmap for tasks" | triaging-tasks.md |
| Update | "Update task scope", "add a phase to tasks/003-…", "replan" | updating-task.md |
| Block / Unblock | "Block this task", "waiting on design review", "Unblock tasks/002-…", "dependency resolved" | blocking-task.md |
| Cancel | "Cancel task", "abandon tasks/005-…", "stop this task" | cancelling-task.md |
Reference index
Contract
task-contract.md — resolve root, layout, status, auto-archive, dependency resolve, discovery, task-agent roots.
| Doc | When to use |
|---|---|
| task-contract.md | Tasks root marker, layout, frontmatter, status, auto-archive, Depends on, discovery, task-agent roots |
| creating-task.md | New task folder; planning only |
| creating-multiple-tasks.md | Multiple new folders via task-planner |
| executing-task.md | Run next_step_id for one folder; verify and archive on Done |
| executing-multiple-tasks.md | Backlog loop via task-triager then task-implementer |
| triaging-tasks.md | Status report, readiness report, or execution roadmap |
| finding-task-agents.md | Gate orchestration on existing task agents |
| creating-task-agents.md | User-invoked create/refresh of task agents |
| updating-task.md | Amend plan.md and sync status.md |
| blocking-task.md | Mark blocked or clear blocker |
| cancelling-task.md | Cancel and auto-archive |