Creating Skills

Structural Requirements

.agent/skills/<skill-name>/
├── SKILL.md          # Required
├── scripts/          # Optional – helper scripts
├── examples/         # Optional – reference implementations
└── resources/        # Optional – templates or assets

SKILL.md Standards

YAML Frontmatter rules

• name: gerund form, lowercase, hyphens only, max 64 chars (e.g. testing-code)
• description: third-person, includes specific trigger keywords, max 1024 chars

Body writing principles

• Be concise — assume the agent is intelligent
• Stay under 500 lines; link to secondary files if more depth is needed ([See ADVANCED.md](ADVANCED.md))
• Always use forward slashes for paths
• Match instruction style to task freedom:
  • High freedom → bullet points (heuristics)
  • Medium freedom → code block templates
  • Low/fragile → exact shell commands

Feedback loops (for complex skills)

• Include a markdown checklist the agent can copy and update
• Follow Plan → Validate → Execute ordering
• For scripts: tell the agent to run --help if usage is unclear

Output Template

When writing a new skill, produce:

SKILL.md

---