opencode-skill-creation-skill

What I do

I guide you through creating a new OpenCode skill from scratch by:

1. Collect Requirements: Prompt for skill name, description, purpose, and category
2. Generate Frontmatter: Create proper YAML frontmatter with all required fields
3. Structure Content: Build complete skill documentation following official standards
4. Validate: Ensure skill meets naming rules and documentation guidelines
5. Create Files: Write SKILL.md to appropriate directory structure

When to use me

Use this when:

• You want to create a new OpenCode skill without manually formatting SKILL.md
• You need to ensure your skill follows official documentation standards
• You want to avoid repetitive setup when creating multiple skills

Ask clarifying questions about:

• Skill's primary purpose and capabilities
• Category for the installer registry (testing, linting, deployment, etc.)
• Prerequisites and dependencies
• Expected inputs and outputs

Prerequisites

• Write access to the skills/ directory
• Understanding of OpenCode skill structure
• Knowledge of the skill's purpose and requirements
• Python 3+ for YAML validation (optional but recommended)

Steps

Step 1: Gather Skill Requirements

Prompt the user for the following information:

Required Fields:

• Name: Unique skill identifier (1-64 chars, lowercase alphanumeric with single hyphens)
• Description: Brief description (1-1024 chars) specific enough for agents to choose correctly
• License: Usually "Apache-2.0" but can be specified

Optional Fields:

• Compatibility: Usually "opencode" but can specify framework compatibility
• Category: Installer-registry grouping (required by build-registry.mjs, init.mjs, setup.sh counts — invisible to OpenCode runtime but never omit)
• Metadata: Opaque string map; only protocol/pattern are house-kept (bats/registry test signals). Do not add audience/workflow/languages/trigger keys

Prompt Template:

Please provide the following information for your new skill:

1. **Skill Name**: (lowercase, alphanumeric, single hyphens, 1-64 chars)
2. **Description**: (1-1024 characters, specific for skill selection)
3. **License**: (default: Apache-2.0)
4. **Compatibility**: (default: opencode)
5. **Target Audience**: (e.g., developers, DevOps, QA)
6. **Workflow Type**: (e.g., testing, linting, deployment)

Example:
  - Name: python-pytest-creator
  - Description: Generate comprehensive pytest test files for Python using test-generator-framework
  - Audience: developers
  - Workflow: testing