agents-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: Standard profile with routing & card fields.
• agent-registry.md: Live registry of all agents.
• 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