OpenCode skills

OpenCode Skills Guide: 7 Regeln für wiederverwendbare KI-Workflows

OpenCode Skills sind wiederverwendbare Anweisungspakete für wiederkehrende Programmierarbeit. Verwende sie, wenn OpenCode eine Prozedur, Fachregel oder Review-Norm behalten soll. Verwende sie nicht als Geheimnisspeicher und nicht als Ersatz für Agents oder MCP.

Primäres Keyword
opencode skill
Aktualisiert am 14. Juli 2026
15 Minuten Lesezeit

Kurzantwort

OpenCode Skills

OpenCode Skills sind wiederverwendbare Anweisungspakete für wiederkehrende Programmierarbeit. Verwende sie, wenn OpenCode eine Prozedur, Fachregel oder Review-Norm behalten soll. Verwende sie nicht als Geheimnisspeicher und nicht als Ersatz für Agents oder MCP. Eine Skill lohnt sich, wenn dieselbe Anweisung in vielen Prompts wiederkommt. Einmalige Hinweise gehören in den Prompt, dauerhafte Vorlieben in Konfiguration oder Dokumentation.

OpenCode Skills Guide: 7 Regeln für wiederverwendbare KI-Workflows
Skills funktionieren am besten als kleine Workflow-Module.

1. Skill nur bei wiederholten Workflows nutzen

Eine Skill lohnt sich, wenn dieselbe Anweisung in vielen Prompts wiederkommt. Einmalige Hinweise gehören in den Prompt, dauerhafte Vorlieben in Konfiguration oder Dokumentation.

Der richtige Test ist ein kleiner Task mit und ohne Skill. Wenn die Skill Wiederholung spart und den Diff verbessert, bleibt sie; sonst wird sie gekürzt.

2. Scope vor dem Schreiben wählen

Projekt-Skills sind leichter zu prüfen, weil sie beim betroffenen Code liegen. Globale Skills können andere Repositories überraschen und sollten nur für wirklich universelle Gewohnheiten gelten.

Sobald Framework, Deploymentziel, Schreibstil oder Compliance erwähnt werden, gehört die Skill meist in das Projekt statt in den globalen Bereich.

OpenCode Skills Guide: 7 Regeln für wiederverwendbare KI-Workflows
Globale Skills für Gewohnheiten, Projekt-Skills für Repository-Regeln.

3. Skills, Commands, Agents und MCP

Eine Skill lohnt sich, wenn dieselbe Anweisung in vielen Prompts wiederkommt. Einmalige Hinweise gehören in den Prompt, dauerhafte Vorlieben in Konfiguration oder Dokumentation.

Eine Skill führt Verhalten, ein Command startet eine benannte Aktion, ein Agent trennt Rolle und Kontext, MCP verbindet externe Tools.

BedarfNutzeVermeide
Checklist wiederholenSkillPrompt kopieren
Benannte AktionCommandVersteckter Prozess
Getrennte RolleAgentRiesige Skill
Externer DienstMCPTokens in der Skill
Repo-RegelnProjekt-SkillÜberraschende globale Skill
OpenCode Skills Guide: 7 Regeln für wiederverwendbare KI-Workflows
Skills, Commands, Agents und MCP lösen unterschiedliche Probleme.

4. Kleine Verträge schreiben

Projekt-Skills sind leichter zu prüfen, weil sie beim betroffenen Code liegen. Globale Skills können andere Repositories überraschen und sollten nur für wirklich universelle Gewohnheiten gelten.

Schreibe Skills wie prüfbare Verträge: Zweck, Auslöser, Schritte, Grenzen und erwartete Evidenz. Was nicht testbar ist, ist zu breit.

5. Praktische Vorlage

Eine Skill lohnt sich, wenn dieselbe Anweisung in vielen Prompts wiederkommt. Einmalige Hinweise gehören in den Prompt, dauerhafte Vorlieben in Konfiguration oder Dokumentation.

Beginne mit einer minimalen Vorlage und ersetze Platzhalter durch echte Projektbefehle. Kleine Skills sind leichter zu prüfen.

---
name: repository-review
description: Use when reviewing code changes in this repository.
---

# Repository Review

1. Inspect the changed files and nearby tests before giving findings.
2. Prioritize bugs, regressions, security risks, and missing validation.
3. Run the documented test command when the touched area has one.
4. Report findings first with file and line references.
5. If no issue is found, say so and mention residual test risk.

6. Geheimnisse und Rechte trennen

Projekt-Skills sind leichter zu prüfen, weil sie beim betroffenen Code liegen. Globale Skills können andere Repositories überraschen und sollten nur für wirklich universelle Gewohnheiten gelten.

Geheimnisse gehören in Umgebungsvariablen, Provider-Login oder Passwortmanager. Die Skill beschreibt den Umgang, speichert aber keine Tokens.

7. Fehler durch kleineren Scope finden

Eine Skill lohnt sich, wenn dieselbe Anweisung in vielen Prompts wiederkommt. Einmalige Hinweise gehören in den Prompt, dauerhafte Vorlieben in Konfiguration oder Dokumentation.

Wenn Ergebnisse schlechter werden, teste vollständige Skill, Kurzversion und normalen Prompt. So erkennst du überlappende Regeln.

FAQ

Was ist eine OpenCode Skill?

Ein wiederverwendbares Anweisungspaket für einen konkreten Workflow oder Qualitätsstandard.

Skill oder Agent?

Skill für Anleitung im aktuellen Ablauf; Agent für getrennte Rolle, Tools oder Kontext.

Wo liegen Projekt-Skills?

Im Projekt, damit das Team sie prüfen und versionieren kann.

Kann eine Skill Befehle ausführen?

Sie kann wichtige Prüfungen nennen, aber Ausführung und Rechte müssen explizit bleiben.

Wie viele Skills?

Starte mit ein oder zwei wertvollen Workflows und erweitere nur bei nachweisbarer Verbesserung.

Verwandter Agents-Leitfaden

Bevor AGENTS.md-Regeln in Subagents aufgeteilt werden, lies den OpenCode Agents Guide. OpenCode Agents Guide.

Quellen

Offizielle Dokumentation geprüft am 2026-07-14; Befehle und Pfade können sich mit OpenCode-Versionen ändern.