When to use
Use this when you need to add a new skill or update an existing skill.
Steps
- •Pick a name: lowercase letters/numbers with single hyphens.
- •Create the directory:
.aoc/skills/<name>/. - •Create
SKILL.mdwith required frontmatter:
markdown
--- name: my-skill description: One-line description of the workflow ---
- •Add the workflow instructions below the frontmatter.
- •Run
aoc-skill validateto confirm naming and frontmatter rules. - •Sync to the active agent:
aoc-skill sync --agent <agent>.
Rules (OpenCode-compatible)
- •
namemust match the directory name. - •Allowed frontmatter keys:
name,description,license,compatibility,metadata. - •Description must be 1-1024 characters.
Regex: ^[a-z0-9]+(-[a-z0-9]+)*$