---
name: "skill-creator"
description: "Leitfaden zur Erstellung oder Aktualisierung von Skills inklusive Update-Workflow für Mastermind."
---

# skill-creator

Leitfaden zur Erstellung oder Aktualisierung von Skills, die Mastermind/OpenClaw durch spezialisiertes Wissen, Workflows oder Tool-Integrationen erweitern.

## Wann verwenden

**MUSS gelesen werden bei jeder Anfrage zum:**
- Erstellen eines neuen Skills
- Aktualisieren / Verbessern eines bestehenden Skills
- Refactoring von Skill-Struktur
- Validieren von SKILL.md-Dateien

## Kernregel

**Bei Änderungs- oder Verbesserungsanfragen IMMER zuerst diesen Skill lesen und den Update-Workflow befolgen, anstatt Dateien direkt zu bearbeiten.**

Skill-Files niemals manuell via `write`/`edit`/`exec` ändern → immer über `skill_workshop` Tool.

## Update-Workflow

1. **Discovery:** `skill_workshop action=list` oder `action=inspect` um den Ziel-Skill / das Proposal zu finden.
2. **Read first:** Den existierenden Skill mit `read` lesen, um den aktuellen Stand zu verstehen.
3. **Plan changes:** Diff im Kopf bilden — was muss raus, was kommt rein?
4. **Propose via tool:**
   - Neuer Skill → `skill_workshop action=create`
   - Existierender Skill → `skill_workshop action=update`
   - Pending Proposal überarbeiten → `skill_workshop action=revise`
5. **Wait for approval:** Proposals sind pending bis der User explizit `apply` anfordert.

## SKILL.md Struktur (empfohlen)

```markdown
# skill-name

Kurze Description (max 160 bytes).

## Wann verwenden
- Konkrete Trigger / Use-Cases

## Voraussetzungen
- Benötigte Tools, Keys, Permissions

## Workflow
1. Schritt-für-Schritt
2. Mit konkreten Tool-Calls

## Beispiele
Praxisbeispiele

## Limits / Fallstricke
Was kann schiefgehen
```

## Best Practices

- **Description ≤ 160 bytes** (sonst lehnt das Tool ab).
- **Beschreibung muss Trigger enthalten** — wann soll der Skill aktiviert werden.
- **Konkrete Tool-Namen nennen** (z.B. `web_search`, `exec`, `browser`).
- **Keine Secrets im SKILL.md.**
- **Beispiele > abstrakte Beschreibungen.**
- **Support-Files** für Templates/Assets/Scripts mit `support_files` Parameter.

## Verbotene Patterns

- ❌ Direktes Schreiben in `~/.openclaw/plugin-skills/.../SKILL.md` via `write`/`edit`
- ❌ Skill-Lifecycle via Shell (`mv`, `rm`, `cp`)
- ❌ Approval/Reject ohne explizite User-Anweisung
- ❌ Description länger als 160 bytes

## Lifecycle-Aktionen (nur auf explizite Anfrage)

- `apply` — Proposal wird zum aktiven Skill
- `reject` — Proposal verworfen
- `quarantine` — Proposal isoliert (potenziell problematisch)
