ai-template/.opencode/skills/create-skill/SKILL.md

name, description, compatibility

name	description	compatibility
create-skill	Guidelines for creating and defining new OpenCode agent skills.	opencode

Create Skill Skill

This skill provides the standardized process for developing reusable behavioral patterns (Skills) in OpenCode.

Workflow

1. Identify a Reusable Pattern: Find a task that is performed repeatedly across sessions or projects (e.g., "Git Release Process", "API Documentation Generation").
2. Create the Skill Directory:
   • Path: .opencode/skills/<skill-name>/
   • Ensure <skill-name> follows naming rules: lowercase alphanumeric, single hyphens, no leading/trailing hyphens.
3. Define the SKILL.md file:
   • Create a SKILL.md file inside the directory.
   • Frontmatter (Required):
     • name: Must match the directory name exactly.
     • description: A concise explanation of what the skill does and when to use it (1-1024 chars).
     • compatibility: Optional, typically set to opencode.
   • Content: Write detailed instructions, checklists, or examples that guide the agent's behavior.
4. Testing & Validation:
   • Call the skill using the skill tool: skill({ name: "<skill-name>" }).
   • Verify that the agent follows the guidelines defined in the content.

Naming Constraints

• 1–64 characters.
• Regex: ^[a-z0-9]+(-[a-z0-9]+)*$

Example Implementation

Directory: .opencode/skills/api-doc-gen/ File: SKILL.md

---
name: api-doc-gen
description: Generates standardized API documentation from source code analysis.
compatibility: opencode
---

# API Documentation Generation

## Steps
1. Analyze the existing endpoints and their request/response bodies.
2. Follow the project's format (e.g., OpenAPI 3.0).
3. Ensure all authentication requirements are documented.