Skill Development Rules
When working with files in .claude/skills/:
SKILL.md Structure
DO
- Keep SKILL.md concise (< 200 lines)
- Include clear "When to Use" section
- Provide copy-paste bash commands
- Reference scripts/ for MCP operations
- Add triggers to skill-rules.json
DON'T
- Include implementation details in SKILL.md
- Duplicate content across skills
- Create skills without corresponding trigger in skill-rules.json
- Use allowed-tools that aren't needed
MCP Wrapper Skills
For skills that wrap MCP scripts:
- Use
allowed-tools: [Bash, Read]to restrict capabilities - Point to the script in scripts/ directory
- Include parameter documentation