writing-skills

To write a discoverable OpenCode Skill, you establish consistent SKILL.md frontmatter with trigger-oriented descriptions and organize supporting references using progressive disclosure patterns for scalable structure.

The RED-GREEN-REFACTOR workflow is a TDD-inspired process for skill authoring that verifies readiness through testing, ensures safe deployment, and validates that your SKILL.md entry meets quality standards.

Structure SKILL.md frontmatter to ensure OSO-friendly discovery by including concise name and description fields with trigger-oriented keywords, enabling cross-referenced documentation patterns for reliable skill activation.

Validate a new Skill before deployment by running rigorous readiness checks, verifying the SKILL.md body structure, and confirming that references, scripts, and assets are organized for maintainability.

Use progressive disclosure in Skill documentation to keep complex references and scripts maintainable, exposing core guidelines in SKILL.md while organizing deeper assets separately for scalable, bulletproof deployment.

OpenCode skill writing requires no external dependencies, relying entirely on internal meta-guidance frameworks to enforce TDD-like verification, frontmatter consistency, and safe deployment readiness checks.