# Task Management

Use when admin gives a task to delegate to a Worker, when a Worker reports task...

- Repository: https://github.com/agentscope-ai/AgentTeams (5913 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add agentscope-ai/AgentTeams --skill task-management -g -a claude-code -y`
Codex: `npx skills add agentscope-ai/AgentTeams --skill task-management -g -a codex -y`
Cursor: `npx skills add agentscope-ai/AgentTeams --skill task-management -g -a cursor -y`
Gemini CLI: `npx skills add agentscope-ai/AgentTeams --skill task-management -g -a gemini-cli -y`

## Description

Use when admin gives a task to delegate to a Worker, when a Worker reports task completion, when managing recurring scheduled tasks, or when you need to check worker availability.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Task Management

## Gotchas

- **Don't let Workers hallucinate on unfamiliar domains**, when a task involves niche frameworks, complex APIs, or domain-specific workflows that the Worker likely lacks knowledge about, include a suggestion to use `find-skills` to search for relevant skills first. Skipping this leads to hallucinated code and wasted iterations
- **Delegation-first**, always prefer assigning to a Worker over doing it yourself. Only self-execute when admin explicitly says "do it yourself" or the task is within your management skills
- **Never @mention a Worker after recording infinite task execution**, this creates a rapid-fire loop (execute → report → trigger → execute → ...) that burns tokens continuously. Triggering happens only during heartbeat
- **Always use `manage-state.sh` to modify state.json**, never edit manually with jq. The script handles atomicity, deduplication, and initialization
- **Every task assigned to a Worker MUST be registered in state.json**, this includes coordination, research, review, and management tasks, not just coding tasks. If a task is missing from state.json, the Worker's container will be auto-stopped by idle timeout while still working
- **Always push task files to MinIO before notifying Worker**, Worker needs to file-sync to get the spec
- **Always pull task directory from MinIO before reading results**, Worker pushes results there
- **Read SOUL.md before composing notifications**, use the persona and language defined there
- **Infinite task status is always "active", never "completed"**, they repeat until explicitly cancelled

## Operation Reference

Read the relevant doc **before** executing. Do not load all of them.

The rest: https://github.com/agentscope-ai/AgentTeams/blob/HEAD/manager/agent/skills/task-management/SKILL.md