Skip to content

skill-description-missing-trigger

Skill description should include trigger phrases so the model knows when to load the skill

Warning

Rule Details

Per the Anthropic skills guide, descriptions should include trigger phrases such as "Use when...", "Use for...", "Use this to...", or quoted trigger words so the AI model can determine when to automatically load and invoke the skill. Without trigger phrases, the model may not activate the skill at the right time. The rule checks for common trigger patterns including "use when", "use for", "use this", "use to", and quoted phrases.

Incorrect

Description without any trigger phrases

yaml
---
name: deploy
description: Deploys the application to production environments
---

Correct

Description with "Use when" trigger phrase

yaml
---
name: deploy
description: Deploys the application. Use when the user asks to ship or release code.
---

Description with quoted trigger phrases

yaml
---
name: deploy
description: Deploys the application. Responds to "deploy", "ship", or "release" commands.
---

Description with "Use for" trigger phrase

yaml
---
name: lint
description: Use for validating code style and catching common errors
---

How To Fix

Add trigger phrases to the description. Use patterns like "Use when the user asks to...", "Use for validating...", or include quoted trigger words that should activate the skill.

Options

This rule does not have any configuration options.

Resources

Version

Available since: v0.2.0