skill-development

To create a Claude Code skill, use this guide to bootstrap a template with recommended frontmatter, write a lean SKILL.md body with imperative instructions, and organize supporting resources like scripts and references into structured directories.

The best way to structure OpenCode skills for enterprise is to enforce consistent frontmatter metadata, maintain a lean core SKILL.md, and bundle resources like scripts and assets into organized directories to support repeatable workflows across teams.

Yes, you can use these skill-development guidelines across personal dotfiles, individual projects, and enterprise deployments, as the provided templates and validation patterns are designed to scale across different deployment contexts.

Frontmatter validation improves Claude skill discovery by enforcing consistent metadata quality, which ensures skills are accurately indexed and triggered, while iteration patterns refine the lean SKILL.md body to maintain execution reliability.

You do not always need to include scripts and references when packaging Claude skills, but bundling these assets is recommended to support complex, repeatable workflows and ensure the skill functions reliably across different environments.

Your Claude Code skill may fail to trigger if the frontmatter lacks clear metadata or the SKILL.md body lacks clearly defined triggers, which this guide addresses by enforcing frontmatter quality and imperative instructions.