Skill Development

Follow conventions for writing and maintaining SKILL.md files including structure, triggers, and MCP wrappers. Use when creating or editing skills. Trigger phrases: "write a skill", "skill file structure", "add skill trigger".

DojoGenesis 80eb74c 965 B Updated

File contents

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

DojoGenesis/plugins/tree/main/plugins/community-skills/skills/skill-development commit 80eb74c9e1

Frequently asked questions

npx skillmds@latest add dojogenesis/skill-development