complete-skill

Structure an OpenCode skill by using a complete template with frontmatter, core SKILL.md content, and optional resources like references, examples, and scripts. This validated layout ensures proper progressive disclosure by separating core logic from extended documentation.

Organize scripts and references by placing them in dedicated directories within the skill structure. This separation provides actionable patterns for runnable examples and automated scripts while keeping the core SKILL.md content concise and focused.

Yes, a frontmatter template is required to build an advanced OpenCode skill. It provides a validated layout that ensures proper metadata configuration and serves as a ready-to-use foundation for demonstrating best practices in skill organization.

Yes, you can use this complete skill structure as a ready-to-use template for new projects. It scaffolds a new skill with all components, including core documentation, references, examples, and automated scripts, following best practices.

Include optional resources like examples in your skill documentation when you need to provide actionable patterns for runnable examples. This progressive disclosure approach keeps the core content lightweight while offering detailed guidance for advanced users.

An OpenCode skill needs a validated layout to ensure proper progressive disclosure and structural integrity. It separates core SKILL.md content from extended resources, providing an educational example for best practices in skill organization.