create-opencode-skill

This skill acts as a structured interface for managing OpenCode Skills, a knowledge-sharing system designed to encapsulate project-specific patterns and reusable workflows. It ensures that all documentation conforms to the mandatory .opencode/skills/ directory structure, enforces file naming conventions, and maintains standardized YAML frontmatter for every skill definition. Developers and AI agents use this skill to programmatically document complex coding standards, internal architecture patterns, and operational guidelines, ensuring consistency across large or distributed codebases. It is particularly valuable for teams aiming to maintain a 'living documentation' repository where project knowledge is machine-readable and easily accessible.

• Automatically initializes new skills within the required .opencode/skills/ kebab-case directory path.

• Generates SKILL.md files with mandated YAML frontmatter (name, description).

• Validates existing skill structures before creation to prevent duplicate or orphaned documentation.

• Enforces imperative tone and clear, actionable headings (##) for high-quality instruction sets.

• Provides a safe-guard workflow that requires manual verification when updating legacy skill files.

• Supports embedding code examples and technical patterns within the skill definitions for easier knowledge transfer.

• To use this skill, invoke commands such as 'create a skill for X' or 'save this pattern as a skill'.

• Always verify the naming convention follows kebab-case to ensure compatibility with the OpenCode resolver.

• When updating existing skills, acknowledge the prompt confirmation to prevent unintended overwrites of established knowledge.

• Utilize the structured format to include specific project technical constraints, framework-specific coding styles (e.g., Spring Boot, SvelteKit), and operational CI/CD workflow requirements.

• The output of this skill is intended to be stored in the repository itself, acting as a direct source of truth for the project's internal knowledge base.