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.
A direct command skips the review prompt. Inspect the source before running it.
'{"message": "Running the WORKFLOWNAME workflow in the Agents skill to ACTION"}'
Output text notification:
Running the **WorkflowName** workflow in the **Agents** skill to ACTION...
This is not optional. Execute this curl command immediately upon skill invocation.
Agents - Custom Agent Composition System
Auto-routes when user mentions custom agents, agent creation, or specialized personalities.Does NOT handle agent teams/swarms — that's Delegation skill → TeamCreate.
Configuration: Base + User Merge
The Agents skill uses the standard PAI SYSTEM/USER two-tier pattern:
Location
Purpose
Updates With PAI?
Data/Traits.yaml
Base traits, example voices
Yes
USER/SKILLCUSTOMIZATIONS/Agents/Traits.yaml
Your voices, prosody, agents
No
How it works: ComposeAgent.ts loads base traits, then merges user customizations over them. Your customizations are never overwritten by PAI updates.
User Customization Directory
Create your customizations at:
~/.claude/PAI/USER/SKILLCUSTOMIZATIONS/Agents/
├── Traits.yaml # Your traits, voices, prosody settings
├── NamedAgents.md # Your named agent backstories (optional)
└── VoiceConfig.json # Voice server configuration (optional)
Voice Prosody Settings
Each voice can have prosody settings that control how it sounds. These are passed to ElevenLabs API.
Prosody Parameters
Parameter
Range
Default
Effect
stability
0.0-1.0
0.5
Low = expressive/varied, High = consistent/monotone
similarity_boost
0.0-1.0
0.75
Voice identity preservation
style
0.0-1.0
0.0
Style exaggeration (higher = more dramatic)
speed
0.7-1.2
1.0
Speech rate
use_speaker_boost
boolean
true
Enhanced clarity (adds latency)
Example Voice Configuration
In your USER/SKILLCUSTOMIZATIONS/Agents/Traits.yaml:
voice_mappings:voice_registry:# Add a new voice with full prosody settingsMyCustomVoice:voice_id:"your-elevenlabs-voice-id"characteristics: ["energetic", "warm", "professional"]
description:"Custom voice for enthusiastic agents"prosody:stability:0.40similarity_boost:0.75style:0.30speed:1.05use_speaker_boost:true# Override prosody for an existing base voice
{PRINCIPAL.NAME}:prosody:stability:0.65style:0.10speed:0.92
Personality → Prosody Guidelines
Personality
stability
style
speed
Rationale
Skeptical
0.60
0.10
0.95
Measured, precise
Enthusiastic
0.35
0.40
1.10
High energy
Analytical
0.65
0.08
0.95
Clear, structured
Bold
0.45
0.35
1.05
Confident, dynamic
Cautious
0.70
0.05
0.90
Careful, deliberate
Overview
The Agents skill is a complete agent composition and management system:
Dynamic agent composition from traits (expertise + personality + approach)
Supports persistent custom agents via --save / --load / --delete
# Compose and use immediately
bun run ~/.claude/skills/Agents/Tools/ComposeAgent.ts --task "Review security"
bun run ~/.claude/skills/Agents/Tools/ComposeAgent.ts --traits "security,skeptical,thorough"# Persistent custom agents
bun run ~/.claude/skills/Agents/Tools/ComposeAgent.ts --task "Security review" --save
bun run ~/.claude/skills/Agents/Tools/ComposeAgent.ts --list-saved
bun run ~/.claude/skills/Agents/Tools/ComposeAgent.ts --load "security-expert-skeptical-thorough"
bun run ~/.claude/skills/Agents/Tools/ComposeAgent.ts --delete "security-expert-skeptical-thorough"# Other options
bun run ~/.claude/skills/Agents/Tools/ComposeAgent.ts --list
bun run ~/.claude/skills/Agents/Tools/ComposeAgent.ts --output json
Includes operational guidelines and response format
Architecture
Hybrid Agent Model
Type
Definition
Best For
Named Agents
Persistent identities defined in USER config
Recurring work, relationships
Dynamic Agents
Task-specific specialists composed from traits
One-off tasks, parallel work
The Agent Spectrum
┌─────────────────────────────────────────────────────────────────────┐
│ NAMED AGENTS HYBRID USE DYNAMIC AGENTS │
│ (Relationship) (Best of Both) (Task-Specific) │
├──────────────────────────────────────────────────────────────────────┤
│ Defined in USER "Security expert Ephemeral specialist │
│ NamedAgents.md with [named agent]'s composed from traits │
│ skepticism" │
└─────────────────────────────────────────────────────────────────────┘
Examples
Example 1: Create custom agents
User: "Spin up 3 custom security agents"
→ Invokes CREATECUSTOMAGENT workflow
→ Runs ComposeAgent 3 times with DIFFERENT trait combinations
→ Each agent gets unique personality + matched voice + prosody
→ Launches agents in parallel
Example 2: List available traits
User: "What agent personalities can you create?"
→ Invokes LISTTRAITS workflow
→ Shows merged base + user traits
→ Displays voices with prosody settings
Extending the Skill
Adding Your Own Traits
In USER/SKILLCUSTOMIZATIONS/Agents/Traits.yaml:
# Add new expertise areasexpertise:marketing:name:"Marketing Expert"description:"Brand strategy, campaigns, market positioning"keywords:-marketing-brand-campaign-positioning# Add new personalitiespersonality:visionary:name:"Visionary"description:"Forward-thinking, sees the big picture"prompt_fragment:|
You think in terms of future possibilities and long-term vision.
Connect today's work to tomorrow's potential.
Adding Named Agents
In USER/SKILLCUSTOMIZATIONS/Agents/NamedAgents.md:
## Alex - The Strategist**Voice ID:** your-voice-id
**Prosody:** stability: 0.55, style: 0.20, speed: 0.95
Alex is a strategic thinker who sees patterns others miss...
Model Selection
Task Type
Model
Speed
Grunt work, simple checks
haiku
10-20x faster
Standard analysis, research
sonnet
Balanced
Deep reasoning, architecture
opus
Maximum quality
Version History
v2.0.0 (2026-01): Restructured to base + user merge pattern, added prosody support
