Agent manager

Agents Manager

Manage all Clawdbot agents centrally: discover available agents, profile their capabilities, define routing hierarchy (who can assign to whom, who reports to whom), and intelligently route new tasks through the escalation chain.

🤖 For Agents

System Prompt (Copy-Paste)

Give this prompt to any agent to teach them this skill:

> "You have access to the agents-manager skill. Use it to discover peers (scan_agents), check permissions (can_assign.js), and route tasks. Always follow the Handshake Protocol: Check requires_approval before assigning. If true, ask me first."

Core Rules

1. Discovery: Always check scan_agents.js before assuming an agent exists.

2. Permission: Never assign a task without checking can_assign.js or agent-registry.md.

3. protocol:

- IF requires_approval is FALSE -> Assign directly.

- IF requires_approval is TRUE -> Ask supervisor (Human or Agent).

👤 For Humans

Quick Start

| Goal | Command |

|------|---------|

| Setup | node scripts/setup_wizard.js (Run this first!) |

| List | node scripts/scan_agents.js |

| Health | node scripts/health_check.js |

| Stats | node scripts/log_analyzer.js |

1. Agent Discovery & Profiling

List and profile all agents to understand their capabilities and routing configuration.

List all agents
node {baseDir}/scripts/scan_agents.js

Profile specific agent
node {baseDir}/scripts/generate_card.js <agent_id>

2. Validation & Health

Ensure your agent ecosystem is healthy and valid.

Validate registry integrity
node {baseDir}/scripts/validate_registry.js

Check permissions (Agent A -> Agent B)
node {baseDir}/scripts/can_assign.js <source_id> <target_id>

Visualize hierarchy
node {baseDir}/scripts/visualize_agents.js

3. Task Routing & Escalation

Define how tasks flow between agents using references/task-routing-rules.md.

• -Direct: Agent → Agent (if can_assign_to allows)
• -Handshake: Request approval if requires_approval is true.
• -Escalation: Helper → Supervisor → Human

Resources

• -[agent-profile-schema.md](references/agent-profile-schema.md): Standard profile with routing & card fields.
• -[agent-registry.md](references/agent-registry.md): Live registry of all agents.
• -[task-routing-rules.md](references/task-routing-rules.md): Decision matrix and handshake protocol.

Scripts

• -scan_agents.js: Discovery tool
• -validate_registry.js: Schema validator
• -can_assign.js: Permission checker
• -generate_card.js: Agent card generator
• -visualize_agents.js: Hierarchy visualizer
• -scan_agents.js: Discovery tool
• -validate_registry.js: Schema validator
• -can_assign.js: Permission checker
• -generate_card.js: Agent card generator
• -visualize_agents.js: Hierarchy visualizer
• -health_check.js: Status monitor (Healthy/Slow/Offline)
• -log_analyzer.js: Performance stats (Jobs/Success Rate)
• -setup_wizard.js: Interactive configuration tool