plugin-create-guide

To create an OpenCode skill, write a SKILL.md file with required YAML frontmatter in a new directory, then restart OpenCode to register the skill. You can optionally add resource directories for scripts, references, and assets.

OpenCode plugins are built with JavaScript or TypeScript, while skills are Markdown-based files using SKILL.md. Both serve as extension mechanisms but differ in implementation language and structural complexity.

No, you do not need JavaScript or TypeScript for Markdown-based skills. You only write a SKILL.md file with YAML frontmatter. JavaScript or TypeScript is required solely for creating OpenCode plugins.

If your new OpenCode skill is not showing up, you likely need to restart OpenCode. The application requires a restart to register newly created SKILL.md files and apply their YAML frontmatter configurations.

Yes, you can include external references and assets in your Markdown skill. The guide supports optional resource directories, allowing you to organize scripts, references, and assets alongside your SKILL.md file.

The best way to structure an OpenCode plugin project is following the provided JavaScript or TypeScript templates. This enforces required YAML frontmatter rules and organizes optional script and asset directories for quick adoption.