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

skill-development