| name | my-skill-name |
| title | My Skill Name (5–60 chars) |
| description | One-line description of what this skill does and when to use it. Be specific — this is what the AI reads when deciding whether to activate the skill. |
| license | Apache-2.0 |
| compatibility | Describe environment requirements: intended product (e.g. Octomind), system tools needed (e.g. git, docker), network access, OS constraints. |
Overview
Describe the skill's purpose in 2–4 sentences. Name the problem, the trigger, and the outcome. No fluff.
Mental model
The core principle that governs all the rules below: ...
Rules
Core rules
- Rule 1: ...
- Rule 2: ...
- Rule 3: ...
Decision guide
| Situation | Action |
|---|
| Case A | Do X |
| Case B | Do Y |
Workflow (if applicable)
- Step one — description
- Step two — description
- Step three — description
Examples
Example 1: Bad → Good
❌ Bad:
[the wrong way]
✅ Good:
[the right way]
What changed:
Example 2: Edge case
Checklist
Composition / References