skill-architect

Creating an OpenCode skill involves running the scaffolding command npx tsx scripts/init.ts <name>, which generates YAML frontmatter, SKILL.md structure, and optional component directories. This establishes the foundational template and structure required for consistent skill design across teams.

OpenCode skills must comply with YAML frontmatter format, SKILL.md documentation structure, archetype guidance, and progressive disclosure patterns. Validation ensures modular design consistency and quality standards before deployment or distribution.

Run npx tsx scripts/validate.ts <path> to check your skill against OpenCode requirements including frontmatter, structure, and archetype alignment. This identifies gaps and ensures compliance before refinement or team handoff.

Skills may include scripts, references, and assets as optional components alongside mandatory YAML frontmatter and SKILL.md documentation. Archetype guidance determines which components fit your skill's scope and use case.

Yes. Scaffolding templates and archetypes provide starting points for skill creation, reducing design time and ensuring alignment with modular design best practices and team standards for documentation and validation.

Archetypes guide skill design decisions during discovery and implementation phases. Select an archetype early to shape component structure, documentation patterns, and validation rules specific to your skill's problem domain and use case.