skill-body-missing-usage-section
SKILL.md body lacks a ## Usage or ## Instructions section
Rule Details
A dedicated ## Usage or ## Instructions section helps users and AI models understand how to invoke and interact with the skill. This rule checks the body content of SKILL.md files for a level-2 heading that starts with "Usage" or "Instructions". Without this section, users must read through the entire file to figure out how to use the skill, reducing discoverability and usability.
Incorrect
SKILL.md body without a Usage section
---
name: deploy
description: Deploys the application
---
# Deploy
This skill deploys the app.
## Configuration
Set environment variables.Correct
SKILL.md body with a Usage section
---
name: deploy
description: Deploys the application
---
# Deploy
## Usage
Run `/deploy staging` to deploy to the staging environment.
## Configuration
Set environment variables.SKILL.md body with an Instructions section
---
name: deploy
description: Deploys the application
---
# Deploy
## Instructions
### Step 1: Configure environment
Set the target environment variable.
### Step 2: Run deployment
Execute the deploy command.How To Fix
Add a ## Usage or ## Instructions section to the body of your SKILL.md file. Include invocation examples, expected arguments, and any flags or options the skill supports.
Options
This rule does not have any configuration options.
Related Rules
Resources
Version
Available since: v0.2.0