my-skill-name

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)

1. Step one — description
2. Step two — description
3. 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

• Pairs with <sibling-skill-in-same-domain> when ...
• Official documentation
• Specification