xuiltul Skill: Subordinate Management (Supervisor Tools)
Supervisor tools automatically enabled for Anima that have subordinates. Most tools work on all descendants (children, grandchildren, great-grandchildren, etc.). delegate_task is restricted to direct subordinates only.
Available Tools
All Descendants (Children, Grandchildren, and Beyond)
| Tool | Purpose |
|---|---|
disable_subordinate |
Pause descendant (status.json enabled: false → process stop + prevent auto-resume) |
enable_subordinate |
Resume paused descendant |
set_subordinate_model |
Change descendant's main LLM model (updates status.json; requires restart_subordinate to take effect) |
set_subordinate_background_model |
Change descendant's background model (for heartbeat/cron; updates status.json; requires restart_subordinate to take effect; empty string to clear) |
restart_subordinate |
Restart descendant process (status.json restart_requested flag; Reconciliation restarts within ~30 seconds) |
delegate_task |
Delegate task to direct subordinate only (queue add + DM send + tracking entry on your side) |
org_dashboard |
Tree view of process status, last activity, current task, and task count for all descendants |
ping_subordinate |
Liveness check for descendants (name omitted = all at once, specified = single) |
read_subordinate_state |
Read descendant's current_state.md |
audit_subordinate |
Comprehensive audit of descendant's recent activity (summary, tasks, errors, tool usage, communication) |
Delegated Task Tracking
| Tool | Purpose |
|---|---|
task_tracker |
Track progress of tasks delegated via delegate_task from the subordinate's queue (status: all / active / completed; default: active) |
Auto-sync (sync_delegated): After each heartbeat completes, the framework may scan subordinates' task queues and automatically update the supervisor's tracking entries to done/failed when delegated work completes or fails (archived tasks are included in the search). You do not have to call task_tracker for every sync; status tends to align around the next heartbeat cycle.
Important: disable_subordinate vs send_message
- disable_subordinate: Sets status.json to
enabled: false. Reconciliation does not auto-resume. Use this one - Sending "take a break" via send_message alone does not stop the process. Reconciliation will restart even after messaging
Usage
Pause and Resume
When pausing multiple subordinates, call disable_subordinate for each one:
disable_subordinate(name="aoi", reason="Temporary pause due to reduced workload")
disable_subordinate(name="taro", reason="Temporary pause due to reduced workload")
enable_subordinate(name="aoi")
Model Change and Restart
Model changes are saved to status.json, but restart_subordinate is required to apply them to the running process:
set_subordinate_model(name="aoi", model="claude-sonnet-4-6", reason="Load balancing")
restart_subordinate(name="aoi", reason="Apply model change")
To change the background model (for heartbeat/cron):
set_subordinate_background_model(name="aoi", model="claude-sonnet-4-6", reason="Reduce heartbeat load")
restart_subordinate(name="aoi", reason="Apply background model change")
To clear the background model and revert to the main model:
set_subordinate_background_model(name="aoi", model="", reason="Unify to main model")
restart_subordinate(name="aoi")
Status Confirmation and Audit
org_dashboard() # Dashboard for all subordinates
ping_subordinate() # Liveness check for all subordinates
ping_subordinate(name="aoi") # Liveness check for single subordinate
read_subordinate_state(name="aoi") # Current task and pending task content
audit_subordinate(name="aoi") # Comprehensive audit of last 1 day
audit_subordinate(name="aoi", days=7) # Audit last 7 days (days: 1–30)
audit_subordinate(since="09:00") # All subordinates since 9:00 today
audit_subordinate(name="aoi", since="13:00") # aoi since 13:00 today
Also available via CLI (useful for S/C/D/G-mode via Bash):
animaworks anima audit aoi # Audit last 1 day
animaworks anima audit aoi --days 7 # Audit last 7 days
animaworks anima audit --all --since 09:00 # All animas since 9:00 today
Task Delegation
delegate_task(name="aoi", instruction="Summarize weekly report", deadline="1d", summary="Weekly report creation")
# name, instruction, deadline are required. summary is optional (defaults to first 100 chars of instruction)
# Specify workspace to have the delegate work in that workspace (see workspace-manager skill)
task_tracker(status="active") # Check progress of delegated tasks (status: all / active / completed)
For assigning workspaces to subordinates (primary working directory), see the workspace-manager skill.
Permissions
- All descendants (recursive): Status, management, and audit tools work on any descendant
- Direct subordinates only:
delegate_task(task delegation) - You cannot operate on yourself