write-a-skill

To create an OpenCode skill, you draft a focused SKILL.md file that defines the task scope, goals, and triggers. This skill guides you through writing the description and organizing supporting files to ensure optimal agent performance.

The best way to write a SKILL.md file is to keep it minimal and targeted, ensuring the description clearly communicates the skill's purpose and triggers. This approach optimizes workflow and ensures correct agent execution.

Supporting scripts are optional when you develop an OpenCode skill. The workflow emphasizes minimal, targeted SKILL.md files, but you can organize and include supporting scripts if the automation task requires them.

You revise an existing skill description by redefining the task scope and rewriting the description to be clear and concise. This skill helps refine your documentation to ensure the agent correctly triggers and executes the automation.

You should not use a minimal SKILL.md approach when your automation workflow requires extensive documentation or complex supporting files. If the task scope demands detailed instructions beyond standard best practices, a more comprehensive structure is needed.