example-skill

An example skill demonstrating the format for opencode-skills plugin

⭐2stars🔀0forks📁View on GitHub🕐Updated Dec 27, 2025

When & Why to Use This Skill

This Claude skill serves as a foundational template and reference guide for developers building native OpenCode skills. It streamlines the development process by providing a standardized format for SKILL.md files, YAML frontmatter, and directory structures, ensuring all custom skills are correctly packaged and discoverable within the OpenCode ecosystem.

Use Cases

  • Standardizing Skill Development: Use this as a boilerplate to ensure new skills adhere to the required YAML frontmatter and directory naming conventions.
  • Developer Onboarding: Provide a clear reference for team members to learn the specific structural rules, such as regex-based naming and relative path referencing, for OpenCode plugins.
  • Format Validation: Cross-reference existing skill files against this template to verify the presence of required fields like name, description, and license for better maintainability.
nameexample-skill
descriptionAn example skill demonstrating the format for opencode-skills plugin
licenseMIT

Example Skill

This is an example skill that demonstrates the format expected by the native OpenCode skills system.

What This Skill Does

This skill helps you understand how to create your own skills for OpenCode.

When to Use This Skill

Use this skill when you need to:

  • Understand how to create a new skill
  • Reference the skill format
  • Learn about skill structure

Instructions

When this skill is activated, you should:

  1. Read the supporting documentation in references/guide.md
  2. Follow the guidelines below

Guidelines

  • Skills are discovered automatically from .opencode/skill/ or ~/.opencode/skill/
  • Each skill must have a SKILL.md file with valid YAML frontmatter
  • Required frontmatter fields: name and description
  • Optional frontmatter fields: license, compatibility, metadata
  • Supporting files can be referenced with relative paths
  • The skill name must match the directory name

Skill Name Rules

The name must:

  • Be 1-64 characters
  • Be lowercase alphanumeric with single hyphen separators
  • Not start or end with -
  • Not contain consecutive --
  • Match the directory name containing SKILL.md

Regex: ^[a-z0-9]+(-[a-z0-9]+)*$

Supporting Files

You can reference supporting files like:

  • references/guide.md - Additional documentation
  • assets/template.html - Files used in output