What problem does it solve?
This Skill helps authors and maintainers create consistent, discoverable Opencode skills by providing templates, conventions, and a step-by-step process so skills are token-efficient, easy to validate, and easy to extend.
Core Features & Use Cases
- Frontmatter & discovery: Clear requirements for name and description to ensure skills are discoverable and correctly triggered.
- Resource organization: Guidance on when to include scripts, references, and assets and how to reference them without bloating context.
- Tooling & validation: Example initializer and quick validator scripts to bootstrap a skill and check frontmatter and structure before use.
- Use Case: An engineer wants to add a PDF-processing skill; they initialize a new skill, add a deterministic script for parsing PDFs, add reference docs for APIs, update SKILL.md with triggers and examples, then run the validator to verify structure.
Quick Start
Initialize a new skill with the provided init_skill.py to create the directory, edit SKILL.md to add name and description, and add only the scripts/references/assets you actually need.