Skill Authoring

This skill documents our conventions, not exhaustive OpenCode capabilities. Omissions are intentional.

What Skills Are

Skills are on-demand context modules that agents load via progressive disclosure. They provide procedural knowledge (workflows, patterns, reference) without bloating always-loaded context.

Skills are: Reusable procedures, patterns, reference guides, tool documentation.

Skills are NOT: Invariants, constraints, or conventions that apply every session (those belong in AGENTS.md).

When to Create a Skill vs. AGENTS.md

Litmus test: Would you want this instruction to apply even when you're not thinking about it? Yes = AGENTS.md (rules, constraints, conventions). No = skill (procedures, reference, workflows).