Menu
Use when you need to create runs, assign tasks to workers, or manage task lifecycle.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when you need to interact with the AgentHub Controller — create tasks, create workers, check status, send heartbeat.
Use when inspecting, registering, summarizing, or handing off task artifacts.
Use when deciding whether existing Workers can handle a goal or whether a new Worker/team should be proposed.
Use when you need to manage Matrix rooms, send messages, or handle room participants.
Use when a Worker, RuntimeLease, Matrix binding, task, or artifact pipeline is stale, failed, or blocked.
Use when managing shared task files and artifact storage. Coordinate file handoffs between workers via shared storage.
| name | task-management |
| description | Use when you need to create runs, assign tasks to workers, or manage task lifecycle. |
Turn user goals into visible task room assignments via the agenthub CLI.
# Read the current Controller operation schema before assigning work.
agenthub schema
# Create a run
agenthub run create --workspace <workspace-id> --goal "Build a website"
# Create and assign a task
agenthub task create --workspace <workspace-id> --title "Build UI" --assign-to <agent-id> --spec "## Goal\n..."
# Apply a declarative Task manifest through Controller assignment
agenthub apply -f task.yaml
# List tasks in a run
agenthub task list --run <run-id>
# Check task status
agenthub task status --id <task-id>
# Retry a failed task
agenthub task retry --id <task-id>
# Cancel a run
agenthub run cancel --id <run-id> --reason "User requested cancellation"
# Get workspace state
agenthub state --workspace <workspace-id>
# Read room timeline
agenthub room events --room <room-id> --limit 20
Use a manifest when the task contract must be reviewed, repeated, or handed to another Manager runtime.
kind: Task
metadata:
name: build-ui
spec:
workspaceId: <workspace-id>
runId: <run-id>
title: Build UI
assignToAgentId: <workspace-agent-id>
taskSpec: |
## Goal
Build the requested UI change.
## Inputs
- Read the room timeline.
- Read shared task artifacts from the referenced task directories.
## Output
- Write result.md.
- Register artifacts through the shared task contract.
workspace_tasks, task_threads, runtime_leases, artifacts, and Matrix timeline. Do not infer completion from a friendly chat reply alone.agenthub schema to confirm Task assignment/apply fields.agenthub run create --workspace <id> --goal "..."agenthub task create --workspace <id> --run <run-id> --title "..." --assign-to <agent-id> or agenthub apply -f task.yaml.agenthub run status --id <run-id> and the task room timeline.