# 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".

- Skill: `dojogenesis/skill-development` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dojogenesis/skill-development`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dojogenesis/skill-development/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: DojoGenesis (https://skillmd.com/u/dojogenesis)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dojogenesis/skill-development

---


# Skill Development Rules

When working with files in `.claude/skills/`:

## SKILL.md Structure

```yaml
```

## 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