skill-description
Skill description must be at least 10 characters, written in third person, with no XML tags
Rule Details
Every skill should include a meaningful description so users and Claude understand its purpose. This rule validates that the description field in SKILL.md frontmatter when present, is at least 10 characters long, written in third person, and free of XML tags. A good description improves discoverability and helps users decide whether a skill fits their needs.
Incorrect
Description too short
---
name: deploy
description: Deploys
---Description with XML tags
---
name: deploy
description: <b>Deploys the app</b> to production
---Correct
Clear third-person description
---
name: deploy
description: Deploys the application to the staging environment
---Detailed description
---
name: test-runner
description: Runs the full test suite and reports coverage metrics
---How To Fix
Add or update the description field in your SKILL.md frontmatter. Use at least 10 characters, write in third person (e.g., "Deploys the app" not "I deploy the app"), and avoid HTML or XML markup.
Options
This rule does not have any configuration options.
Related Rules
Resources
Version
Available since: v0.2.0