Initial commit

2026-06-29 18:48:06 +02:00
commit c8e3e1ebd6
8 changed files with 346 additions and 0 deletions
@@ -0,0 +1,47 @@
+---
+name: create-skill
+description: Guidelines for creating and defining new OpenCode agent skills.
+compatibility: 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`
+```markdown
+---
+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.
+```