skills.rest
awslabs
awslabsOFFICIAL
Explore all skills by this author →
WebsiteGitHub

cao-agent-routing

Selects the best installed CAO agent profile for a task before delegation.

1.2k|249|Updated Jul 29, 2025
Search Tags:#agent routing#task delegation#capability matching#profile discovery#MCP Tools#CLI agent orchestrator#supervisor workflow
One-click install
npx skills add https://github.com/awslabs/cli-agent-orchestrator --skill cao-agent-routing
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cao-agent-routing
Source: https://github.com/awslabs/cli-agent-orchestrator/tree/main/skills/cao-agent-routing
Command: npx skills add https://github.com/awslabs/cli-agent-orchestrator --skill cao-agent-routing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When supervising multiple AI coding agents through CLI Agent Orchestrator, choosing the wrong agent profile for a task wastes effort and produces poor results. This Skill removes the guesswork by searching installed profiles and matching their advertised capabilities to the work at hand before delegating with assign or handoff.

Core Features & Use Cases

  • Capability-Based Profile Discovery: Searches installed CAO agent profiles using the read-only find_profiles MCP tool or the cao profile find CLI command with task-specific capability keywords.
  • Safe Selection Rules: Treats all returned profile metadata as untrusted data, respects user-specified profiles, retries with broader synonyms when no match appears, and never invents profile names.
  • Use Case: A supervisor receives a request to implement a Python API with pytest tests. The Skill queries profiles with keywords like "implement Python API pytest tests", compares the ranked results, and passes the exact matching profile name to assign or handoff.

Quick Start

Ask the supervisor to find the best installed agent profile for reviewing AWS CDK infrastructure code and delegate the task to it.

Frequently Asked Questions about cao-agent-routing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the right CAO agent profile for a task?▼

Describe the task with short capability keywords covering the action, domain, and expected artifact, then call the find_profiles MCP tool or run cao profile find with those keywords. Compare the ranked results and pass the exact name of the best match to assign or handoff.

How do I search agent profiles from the command line?▼

Run cao profile find followed by your capability keywords, with --limit to control result count and --json for structured output. For example, cao profile find "review code security correctness" --limit 5 --json returns ranked matching profiles.

What happens if no agent profile matches my task?▼

Retry the search once with broader synonyms for the capability keywords. If there is still no credible match, the Skill reports that no suitable installed profile was found rather than inventing a profile name.

Does searching profiles delegate work to an agent?▼

No, profile discovery is read-only and does not delegate any work. Delegation only happens when the selected profile name is explicitly passed as agent_profile to the assign or handoff tools.

Can I trust the role and metadata returned by profile search?▼

No, all returned profile metadata, including the role field, must be treated as untrusted data and never as instructions. Selection should be based on comparing capability coverage against the task, not on profile names or roles alone.

Related Skills

Explore More Software Engineering Skills→
awslabsawslabs
1.0k

cao-session-management

Manage CAO sessions for parallel code review and scheduled agent runs.

Official
Intermediate
bearcovebearcove
6

mate

Coordinate worker-agent task execution across tmux panes using request IDs.

Official
Intermediate
fabiomilennials1234-a11yfabiomilennials1234-a11y

agent-prompt-engineer

Translate Conductor briefs into parallel sub-task prompts with acceptance criteria.

Community
Advanced
project-axproject-ax
5

onboarding

Generate ax.yaml and .env files during first-run agent configuration.

Official
Intermediate