add-skill

To create a standardized SKILL.md file, you must include YAML frontmatter with a defined name and description. This ensures your agent skills remain discoverable and properly structured for OpenCode or Claude automation workflows.

The required structure for writing agent skills is a SKILL.md file containing YAML frontmatter with name and description fields. You can also add optional directories for scripts, references, and assets to organize content.

When building agent skills, you organize optional directories by placing them under the specific skill folder alongside the SKILL.md file. Correctly using scripts, references, and assets directories maintains skill quality and discoverability.

Yes, the skill template enforces validation by requiring consistent YAML frontmatter, naming conventions, and structural organization. This maintains discoverability and quality across a library of skills used by AI agents.

Yes, you can use this skill to update existing skill descriptions. It applies when authoring new SKILL.md files, updating current skill descriptions, or organizing content for OpenCode and Claude agents.

The best way to maintain quality across a library of agent skills is to enforce consistent YAML frontmatter, standardized naming, and proper structural organization. This ensures all Skill Units remain validated and discoverable.