Writing Effective Descriptions

The description field is THE routing key. Claude reads descriptions to decide whether to invoke an agent or skill. Poor descriptions = artifacts that never trigger.

The Formula

{Role/expertise}. Use [PROACTIVELY] when {specific trigger conditions}.

• Role/expertise: What the agent/skill does (third person for skills)
• PROACTIVELY: Include if Claude should invoke without being asked
• Trigger conditions: Specific situations that warrant invocation

Agent Description Examples

By Category