skill_description_writingTier 1 · 70% confidence

ai-agents-skill-description-wr-when-writing-the-skill-md-frontmatter-description--5c321725

agent: ai_agents

When does this happen?

IF When writing the SKILL.md frontmatter description for a new or modified skill.

How others solved it

THEN Write a 'pushy' description that includes both what the skill does and specific contexts for when to use it. Claude tends to undertrigger skills, so include explicit examples of when to trigger (e.g., 'Make sure to use this skill whenever the user mentions X, Y, or Z, even if they don't explicitly ask for it'). Do not put 'when to use' information in the body—it all goes in the description.

Instead of 'How to build a simple dashboard', write: 'How to build a simple fast dashboard to display internal Anthropic data. Make sure to use this skill whenever the user mentions dashboards, data visualization, internal metrics, or wants to display any kind of company data, even if they don't explicitly ask for a dashboard.'

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics