$npx -y skills add chenhg5/agencycli --skill task-managementCreate, assign, monitor, and close tasks across agents. Covers full task lifecycle — add, priority, dependencies, confirm-request, retry, cancel, bulk ops, and cross-agent search.
| 1 | # Skill: Task Management |
| 2 | |
| 3 | Use this skill when your role involves planning, delegating, and tracking work across agents. The agency workspace is at `$AGENCY_DIR`. |
| 4 | |
| 5 | --- |
| 6 | |
| 7 | ## Priority levels |
| 8 | |
| 9 | | Value | Label | When to use | |
| 10 | |-------|----------|-------------| |
| 11 | | 0 | critical | Blocking production / blocking other agents | |
| 12 | | 1 | high | Should be picked up in the current cycle | |
| 13 | | 2 | normal | Default — regular backlog work | |
| 14 | | 3 | low | Nice-to-have, do when free | |
| 15 | |
| 16 | --- |
| 17 | |
| 18 | ## Create a task for an agent |
| 19 | |
| 20 | ```bash |
| 21 | # Minimal |
| 22 | agencycli --dir $AGENCY_DIR task add \ |
| 23 | --project <project> --agent <agent> \ |
| 24 | --title "Short title" \ |
| 25 | --prompt "Detailed instructions for the agent..." |
| 26 | |
| 27 | # With priority and type |
| 28 | agencycli --dir $AGENCY_DIR task add \ |
| 29 | --project <project> --agent <agent> \ |
| 30 | --title "Fix auth bug" \ |
| 31 | --prompt "Reproduce with: curl -X POST /login with empty password. Root cause is in auth/validator.go." \ |
| 32 | --priority 1 \ |
| 33 | --type bug |
| 34 | |
| 35 | # With dependencies (task will not start until listed IDs are done) |
| 36 | agencycli --dir $AGENCY_DIR task add \ |
| 37 | --project <project> --agent <agent> \ |
| 38 | --title "Deploy to staging" \ |
| 39 | --prompt "Run: make deploy-staging" \ |
| 40 | --depends-on <task-id-1> --depends-on <task-id-2> |
| 41 | |
| 42 | # With scheduling / nesting metadata |
| 43 | agencycli --dir $AGENCY_DIR task add \ |
| 44 | --project <project> --agent <agent> \ |
| 45 | --title "Implement sub-feature" \ |
| 46 | --prompt "..." \ |
| 47 | --parent <parent-task-id> \ |
| 48 | --due-date 2026-07-15 \ |
| 49 | --estimate-duration 2h |
| 50 | ``` |
| 51 | |
| 52 | ### Task metadata fields |
| 53 | |
| 54 | | Field | CLI flag | Notes | |
| 55 | |-------|----------|-------| |
| 56 | | Due date | `--due-date YYYY-MM-DD` | Deadline | |
| 57 | | Estimate | `--estimate-duration 30m` | Go duration (`30m`, `2h`) | |
| 58 | | Parent | `--parent <task-id>` | Sub-task nesting | |
| 59 | | Labels | `--label` (repeatable) | Tags | |
| 60 | | Started / finished | *(auto)* | Set when status → `in_progress` / terminal | |
| 61 | |
| 62 | |
| 63 | ### Task types |
| 64 | |
| 65 | `feature` · `bug` · `chore` · `review` · `deploy` · `research` · `wakeup` · (custom string) |
| 66 | |
| 67 | --- |
| 68 | |
| 69 | ## Inspect task queues |
| 70 | |
| 71 | ```bash |
| 72 | # All active tasks for one agent (sorted by priority) |
| 73 | agencycli --dir $AGENCY_DIR task list --project <project> --agent <agent> |
| 74 | |
| 75 | # Filter by status |
| 76 | agencycli --dir $AGENCY_DIR task list --project <project> --agent <agent> --status pending |
| 77 | agencycli --dir $AGENCY_DIR task list --project <project> --agent <agent> --status in_progress |
| 78 | |
| 79 | # Include archived (completed / cancelled) tasks |
| 80 | agencycli --dir $AGENCY_DIR task list --project <project> --agent <agent> --archived |
| 81 | |
| 82 | # Show full detail of a specific task (project + agent known) |
| 83 | agencycli --dir $AGENCY_DIR task show <task-id> --project <project> --agent <agent> |
| 84 | |
| 85 | # Find a task anywhere by ID (no project/agent needed) |
| 86 | agencycli --dir $AGENCY_DIR task find --id <task-id> |
| 87 | ``` |
| 88 | |
| 89 | --- |
| 90 | |
| 91 | ## Update task fields |
| 92 | |
| 93 | ```bash |
| 94 | # Only flags you pass are changed; project/agent auto-detected if omitted |
| 95 | agencycli --dir $AGENCY_DIR task set <task-id> --priority 1 |
| 96 | agencycli --dir $AGENCY_DIR task set <task-id> --status in_progress |
| 97 | agencycli --dir $AGENCY_DIR task set <task-id> \ |
| 98 | --due-date 2026-07-15 --estimate-duration 2h --parent <parent-task-id> |
| 99 | agencycli --dir $AGENCY_DIR task set <task-id> --label bug --label urgent |
| 100 | agencycli --dir $AGENCY_DIR task set <task-id> --due-date "" # clear due date |
| 101 | agencycli --dir $AGENCY_DIR task set <task-id> --format json # print updated task |
| 102 | ``` |
| 103 | |
| 104 | Updatable: `title`, `description`, `status`, `priority`, `type`, `summary`, `label`, |
| 105 | `parent`, `due-date`, `estimate-duration`, `assignee`, `prompt` / `prompt-file`, `position`. |
| 106 | |
| 107 | Status changes auto-maintain `started_at` / `finished_at`. |
| 108 | |
| 109 | --- |
| 110 | |
| 111 | ## Monitor progress across agents |
| 112 | |
| 113 | To get an overview of all agents and their queue depths: |
| 114 | |
| 115 | ```bash |
| 116 | agencycli --dir $AGENCY_DIR overview |
| 117 | ``` |
| 118 | |
| 119 | To iterate agents and check queues programmatically: |
| 120 | |
| 121 | ```bash |
| 122 | # List all agents in a project |
| 123 | agencycli --dir $AGENCY_DIR list agents --project <project> |
| 124 | |
| 125 | # Then per agent |
| 126 | agencycli --dir $AGENCY_DIR task list --project <project> --agent <agent> --status pending |
| 127 | agencycli --dir $AGENCY_DIR task list --project <project> --agent <agent> --status in_progress |
| 128 | ``` |
| 129 | |
| 130 | --- |
| 131 | |
| 132 | ## Task stats (throughput & efficiency) |
| 133 | |
| 134 | ```bash |
| 135 | # Today by executor queue (default: all agents, grouped) |
| 136 | agencycli --dir $AGENCY_DIR task stats --since today |
| 137 | |
| 138 | # One agent's queue |
| 139 | agencycli --dir $AGENCY_DIR task stats --since today --project <project> --agent <agent> |
| 140 | |
| 141 | # By assignee field |
| 142 | agencycli --dir $AGENCY_DIR task stats --since today --assignee <project>/<agent> |
| 143 | agencycli --dir $AGENCY_DIR task stats --since 7d --by assignee |
| 144 | |
| 145 | # By label (evening summary: value / category buckets) |
| 146 | agencycli --dir $AGENCY_DIR task stats --since today --by label:value |
| 147 | agencycli --dir $AGENCY_DIR task stats --since today --by label:category |
| 148 | agencycli --dir $AGENCY |