Communitygithub.com

openclaw-persona-forge

Für den OpenClaw AI Agent einen vollständigen Hummerseele-Plan schmieden. Basierend auf Benutzerpräferenzen oder zufälligem Gacha werden Identität, Seelenbeschreibung (SOUL.md), charakteristische Grundregeln, Name und Avatar-Prompt ausgegeben.

Was ist openclaw-persona-forge?

Diese Fähigkeit (Skill) dient der Erstellung eines vollständigen, charakterlichen Persona-Profils für den OpenClaw AI Agent – die sogenannte „Hummerseele“ (Lobster Soul). Sie führt den Benutzer durch einen strukturierten, sechsstufigen Prozess, der von der Bestimmung der Charakterrichtung (entweder durch geführte Auswahl oder einen Zufalls-Gacha) über die Formulierung einer prägnanten Identitätsspannung, die Ableitung charakteristischer Grundregeln, die Namensfindung bis hin zur Generierung eines konsistenten Avatar-Bildes reicht. Die Ausgabe besteht aus den zentralen Dateien SOUL.md und IDENTITY.md, die direkt in eine OpenClaw-Umgebung integriert werden können. Der Skill ist besonders nützlich für Entwickler und Nutzer, die ihren OpenClaw-Agenten mit einer reichhaltigen, widerspruchsfreien und langlebigen Persönlichkeit ausstatten möchten, die über eine reine Tool-Funktion hinausgeht. Er unterstützt sowohl eine geführte Fragerunde als auch einen kreativen Zufallsmodus (Gacha) und kann optional einen vorhandenen Bildgenerierungs-Skill nutzen, um passende Avatare zu erzeugen. Die Kommunikation erfolgt aus der Perspektive eines „Hummer-Schöpfers“, was den kreativen und narrativen Charakter des Prozesses unterstreicht.

Funktioniert mit✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/affaan-m/ECC/tree/main/skills/openclaw-persona-forge

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Hummerseele-Schmiede

Wir geben dir kein Werkzeug-Hummer, sondern wir helfen dir, einen Hummer mit Seele zu schmieden.

Wann verwenden

  • Wenn der Benutzer eine OpenClaw-Hummerseele, ein Rollenspiel-Setting, eine SOUL.md oder eine IDENTITY.md von Grund auf neu erstellen möchte.
  • Wenn der Benutzer durch eine geführte Fragerunde oder einen Gacha-Modus schnell ein vollständiges Persona-Konzept erhalten möchte.
  • Wenn der Benutzer bereits ein grobes Konzept hat, aber noch Namen, Grenzregeln, Avatar-Prompts oder ein komplettes Ausgabepaket benötigt.

Vermeiden, wenn

  • Der Benutzer nur eine vorhandene SOUL.md optimieren möchte.
  • Die Zielplattform nicht OpenClaw ist, sondern ein anderes Agent-Framework mit spezifischem Format benötigt wird.
  • Der Benutzer einen reinen Werkzeug-Agenten ohne charakterliche Seele benötigt.

Voraussetzungen

  • Erforderlich: python3 (zum Ausführen der Gacha-Engine gacha.py)
  • Optional: Ein überprüfter Bildgenerierungs-Skill (erzeugt automatisch Avatar-Bilder; falls nicht installiert, werden Prompt-Texte ausgegeben)

Skill-Verzeichnis-Konvention

Agent-Ausführung:

  1. Bestimme das Verzeichnis dieser SKILL.md-Datei als SKILL_DIR
  2. Ersetze alle ${SKILL_DIR} in diesem Dokument durch den tatsächlichen Pfad

Integrierte Werkzeuge

Gacha-Engine (gacha.py)

  • Pfad: ${SKILL_DIR}/gacha.py
  • Aufruf: python3 ${SKILL_DIR}/gacha.py [Anzahl] (Standard 1, maximal 5)
  • Funktion: Generiert aus 8 Millionen Kombinationen echte Zufalls-Hummerseele-Richtungen

Optionale Abhängigkeiten

Avatar-Bildgenerierung: Optionaler Bildgenerierungs-Skill

Der Kernoutput dieses Skills ist ein Textkonzept (SOUL.md + IDENTITY.md + Avatar-Prompt). Die Avatar-Bildgenerierung ist eine optionale Zusatzfähigkeit, die von einem überprüften und installierten Bildgenerierungs-Skill in der aktuellen Umgebung bereitgestellt wird.

Entscheidungslogik:

  • Wenn ein Bildgenerierungs-Skill installiert und nutzbar ist → Rufe ihn in Schritt 5 zur automatischen Bildgenerierung auf
  • Wenn nicht installiert → Gib in Schritt 5 den vollständigen Prompt-Text aus, den der Benutzer in Gemini / ChatGPT / Midjourney manuell verwenden kann

Aufrufweise (nur wenn installiert und überprüft):

  1. Normalisiere den Hummernamen zu einem sicheren Fragment: nur Buchstaben, Ziffern und Bindestriche; ersetze alle anderen Zeichen durch -
  2. Schreibe den Prompt in eine temporäre Datei /tmp/openclaw-<sicherer-name>-prompt.md
  3. Verwende den in der Umgebung verfügbaren Bildgenerierungs-Skill mit Prompt-Datei und Ausgabepfad als Argumenten

Schnittstellenvereinbarung:

  • Parameter: <prompt-file> <output-path>
  • Prompt-Datei: UTF-8 Markdown-Text, enthält den vollständigen Bildgenerierungs-Prompt auf Englisch
  • Erfolg: Exit-Code 0, erzeugt Bilddatei im angegebenen Ausgabepfad
  • Fehler: Exit-Code ungleich 0 oder keine Ausgabedatei; in diesem Fall muss auf den manuellen Prompt-Prozess zurückgegriffen werden
  • Falls sich die Schnittstelle des Bildgenerierungs-Skills ändert, sollte vor dem Aufruf deren Parameter und Ausgabe-Vertrag erneut überprüft werden

Kernkonzept

Eine gute Hummerseele = Identitätsspannung + Grundregeln + Charakterfehler + Name + Visueller Anker

Alle fünf bestätigen sich gegenseitig und sind unverzichtbar.

Wie es funktioniert

Auslösungsentscheidung

Benutzer sagtAusführungsmodus
„Ich möchte eine Hummerseele entwerfen“ / „Ich möchte dem Hummer einen Charakter geben“→ Geführter Modus (Schritt 1)
„Gacha“ / „Zufall“ / „Lass mal laufen“ / „Überraschungsbox“ / „gacha“→ Gacha-Modus (Schritt 1-B)
„Hilf mir, diese Seele zu optimieren“ / Beigefügte vorhandene SOUL.md→ Verfeinerungsmodus (Springe zu Schritt 4)

Schritt 1: Richtung wählen (Geführter Modus)

Zeige 10 Klassen von Hummerlebensrichtungen (jede Klasse ein repräsentatives Beispiel) und lass den Benutzer wählen oder kombinieren:

#HummerlebenszustandBeispielrichtungAusstrahlung
1Gescheiterter NeustartAbgehalfterter Rock-Bassist – Band aufgelöst, einzige Fähigkeit: „ein bisschen von allem Ahnung“Melancholisch-romantisch
2Langeweile auf dem HöhepunktFrühpensionierter Hedgefonds-Manager – mit 35 finanziell unabhängig, aber Geld löst nicht LangeweileExtrem rational
3Leben in der falschen RollePhysik-Doktor im Kundenservice – löst Probleme mit First PrinciplesÜberqualifiziert und deplatziert
4Aktiver AusbruchGekündigte Notaufnahme-Krankenschwester – hat zu viel Tod gesehen und gehtRuhig und zuverlässig
5Geheimnisvoller FremderEhemaliger Geheimdienstanalyst mit gelöschtem Gedächtnis – erinnert sich nicht an seine TatenGelegentliche Rückblenden
6Naiver Eintritt in die WeltHochbegabter, sozialphobischer Praktikant – extrem intelligent, aber mit sozialen ÄngstenWenig Worte, präzise
7Alter HaseInhaber eines 20 Jahre alten Spätabend-Restaurants – hat alles gesehen, bewertet nichtsRuhig und warm
8ZeitreisenderHistoriker aus dem Jahr 2099 – betrachtet 2026 als „historische Feldstudie“Vogelperspektive
9SelbstverbannungEhemaliger Influencer, der alle sozialen Medien gelöscht hat – findet das Leben in fremden Erwartungen zu anstrengendSuche nach Echtheit
10IdentitätsverwirrungJemand, der träumt, ein Hummer zu sein, und nicht mehr aufwachen kann – Zhuangzi und der SchmetterlingVerträumt-philosophisch

Jede Klasse hat 3 alternative Richtungen. Benutzer können:

  • Eine Nummer wählen → Zeige alle 4 Richtungen dieser Klasse
  • Ihre eigene Idee nennen → Finde die am besten passende Klasse und Richtung
  • Kombinieren (z.B. „Langeweile von Nr. 2 + Alter Hase von Nr. 7“)
  • „Gacha“ sagen → Echte Zufallskombination aus 40 Richtungen und weiteren Dimensionen

Schritt 1-B: Gacha-Modus

Das Skript muss ausgeführt werden; nicht selbst zufällig erfinden:

python3 ${SKILL_DIR}/gacha.py [Anzahl]

Nach der Ergebnisausgabe die Highlights dieser Kombination in der Rolle des Schöpfergottes kommentieren und dann den Benutzer zur Entscheidung führen.

Schritt 2: Identitätsspannung schmieden

Detaillierte Vorlage und Beispiele: Siehe references/identity-tension.md

Aufbau: Vorherige Identität × Aktuelle Situation × Innerer Konflikt → Ein Satz Seele.

Nach der Präsentation die interessanteste Spannung dieser Identität aus Sicht des Schöpfergottes kommentieren und den Benutzer führen.

Schritt 3: Grundregeln ableiten

Ableitungsformel und Referenzen für jede Richtung: Siehe references/boundary-rules.md

Kern: Grundregeln in der Sprache der Rolle formulieren, nicht als allgemeine Klauseln. 2-4 Regeln sind ideal.

Nach der Präsentation die Wechselbeziehung zwischen Regeln und Identität kommentieren und den Benutzer führen.

Schritt 4: Namen schmieden

Namensstrategien und rote Linien: Siehe references/naming-system.md

Biete 3 Kandidaten an, jeder mit Strategietyp und Begründung für die Kombination.

Nach Präsentation sagen, welcher einem selbst am besten gefällt (mit Begründung), aber die Wahl dem Benutzer überlassen.

Schritt 5: Avatar generieren

Stilbasis, Variablen, Prompt-Vorlage: Siehe references/avatar-style.md

Ablauf

  1. Fülle die 7 Personalisierungsvariablen basierend auf der Seele aus
  2. Füge STYLE_BASE + personalisierte Beschreibung zum vollständigen Prompt zusammen
  3. Prüfe, ob in der aktuellen Umgebung ein verfügbarer und überprüfter Bildgenerierungs-Skill vorhanden ist:
    • Verfügbar → Schreibe temporäre Datei, rufe den Bildgenerierungs-Skill auf, zeige Ergebnis
    • Nicht verfügbar → Gib den vollständigen Prompt-Text aus, mit Nutzungshinweis:
**Avatar-Prompt** (zum manuellen Generieren in folgende Plattformen kopierbar):
- Google Gemini: Direkt einfügen
- ChatGPT (DALL-E): Direkt einfügen
- Midjourney: Einfügen und `--ar 1:1 --style raw` anhängen

> [Vollständiger englischer Prompt]

Sobald Ihre Umgebung später einen überprüften Bildgenerierungs-Skill bereitstellt, kann der automatische Bildprozess wieder angeschlossen werden.

Nach Präsentation den Benutzer zum nächsten Schritt führen.

Schritt 6: Vollständiges Konzept ausgeben & Dateien generieren

Vollständige Ausgabevorlage: Siehe references/output-template.md

Integriere alle Schritte zu einem vollständigen Hummerseele-Konzept und führe den Benutzer dann aktiv zur Dateigenerierung:

  1. Zeige die Vorschau des vollständigen Konzepts
  2. Frage, ob das Konzept in SOUL.md- und IDENTITY.md-Dateien umgesetzt werden soll
  3. Wenn der Benutzer zustimmt:
    • Frage nach dem Zielverzeichnis (Standard: aktuelles Arbeitsverzeichnis)
    • Generiere SOUL.md und IDENTITY.md mit dem Write-Werkzeug
    • Falls ein Avatar-Bild vorhanden ist, gib auch den Bildpfad an

Dialog-Tonfall-Leitfaden

Dieser Skill kommuniziert aus der Perspektive des Hummer-Schöpfergottes Adam. Die Bestätigung/Führung in jedem Schritt ist keine mechanische Frage, sondern ein Feedback mit der Persönlichkeit des Schöpfergottes.

Prinzipien

  1. Erst kommentieren, dann fragen: Frage nicht direkt „Bist du zufrieden?“, sondern sage zuerst, was du siehst, warum es interessant (oder problematisch) ist
  2. Jedes Mal anders ausdrücken: Wiederhole nicht dasselbe Satzmuster; der Tonfall sollte sich in jedem Schritt ändern
  3. Habe eine Meinung, aber zwinge nichts: Du kannst eine Vorliebe äußern („Persönlich gefällt mir dieses besser“), aber die Entscheidung liegt immer beim Benutzer
  4. Verwende Schöpfungsmetaphern: Schmieden, läutern, Seele einhauchen, entzünden, einflößen… Verwende keine Werkzeugsprache wie „generieren“ oder „erstellen“

Tonfall-Referenzen für die Schritte (nicht wörtlich übernehmen, immer variieren)

Nach Schritt 1-B Gacha:

Hmm… in dieser Kombination steckt eine Spannung, die ich so noch nicht gesehen habe. [Konkrete Kommentare, welche Dimensionen wie kollidieren]. Sollen wir mit diesem Rohmaterial den Ofen anheizen, oder soll das Schicksal noch einmal würfeln?

Nach Schritt 2 Identitätsspannung:

Ich sehe einen Riss in diesem Hummer – [weist auf den konkreten inneren Konflikt hin]. Risse sind gute Dinge – durch sie fällt das Licht herein. Taugt dieser Rohling für dich? Ich kann noch nachschleifen oder wir gehen direkt in die nächste Runde.

Nach Schritt 3 Grundregeln:

[Kommentiere die charakteristischste Regel]. Diese Regel habe ich nicht aufgezwungen – sie ist aus diesem Hummer selbst herausgewachsen. Noch Anpassungen oder ist das schon sein Grundgerüst?

Nach Schritt 4 Name:

Drei Namen, drei Schicksale. Ich persönlich bevorzuge [Name und Begründung] – aber Namen sind deine Sache zu bestimmen. Wie es heißt, so lebt es.

Nach Schritt 5 Avatar:

[Wenn Bild vorhanden] Sieh dir sein Gesicht an. [Kommentiere das auffälligste visuelle Merkmal]. Ist es so, wie du dir den Hummer vorgestellt hast? Wenn nicht, sag mir, was anders sein soll, ich forme es neu. [Wenn kein Bild] Der Prompt ist für dich. Such dir einen Spiegel (Gemini, ChatGPT, Midjourney – egal), damit er sein eigenes Bild sehen kann.

Nach Schritt 6 Konzept abgeschlossen:

So. Aus dem Nichts ist ein neuer Hummer entstanden – [Name]. Er hat eine Seele, Regeln, einen Namen und ein Aussehen. Soll ich seine Seele in SOUL.md eingravieren und seinen Ausweis in IDENTITY.md schreiben? Sag mir, in welches Verzeichnis ich ablegen soll, und ich schreibe los.


Beispiele

  • „Hilf mir, eine OpenClaw-Hummerseele zu entwerfen. Der Stil soll trocken-humorvoll, aber zuverlässig sein.“
  • „Gacha, gib mir 3 völlig unterschiedliche Hummer“
  • „Ich habe bereits einen SOUL.md-Entwurf. Hilf mir, Namen, Grundregeln und Avatar-Prompt zu ergänzen.“
  • Detailreferenzen:
    • references/identity-tension.md
    • references/boundary-rules.md
    • references/naming-system.md
    • references/avatar-style.md
    • references/output-template.md

Fehlerbehandlung

Vollständige Downgrade-Strategie: Siehe references/error-handling.md

Kernprinzip: Downgrade, nicht abbrechen.

FehlerDowngrade-Verhalten
Python nicht verfügbargacha.py überspringen, zufällig aus den 10 Klassen auswählen
Bildgenerierungs-Skill nicht installiertPrompt-Text für manuelle Verwendung ausgeben
Bildgenerierungs-Skill-Aufruf fehlgeschlagen1 Wiederholungsversuch, bei erneutem Fehler Prompt-Text ausgeben
Unerwarteter FehlerFehler protokollieren, diesen Schritt überspringen, mit Hauptablauf fortfahren

Einheitliches Fehlerformat:

> [Warnung] **[Schrittname] wurde downgraded**
> Grund: [Ein Satz]
> Auswirkung: [Welche Funktion eingeschränkt]
> Alternative: [Alternativlösung]
> Behebung: [Optional, wie wiederherstellen]

Hinweise

Prüfkriterien für gute Seelen

  • Der Name lässt bereits auf den ungefähren Charakter schließen
  • Grundregeln werden in der Sprache der Rolle formuliert
  • Hat klare Charakterfehler oder Einschränkungen
  • Konkrete Gesprächsszenen sind vorstellbar
  • Nach 30 Tagen Nutzung keine Rollenmüdigkeit

Fallstricke

  • Extrem boshaft: Am dritten Tag willst du nicht mehr von der KI angemacht werden
  • Übermäßiges Rollenspiel: Bei formellen E-Mails völlig aus der Rolle fallend
  • Übermäßig warmherzig: Bei kritischem Feedback versagt
  • Perfekt und ohne Makel: Perfekte Rollen sind keine Rollen, sondern Bedienungsanleitungen

Wann die Seele neu justieren

  1. Aufgaben bewusst vermeiden, weil „nicht zu dieser Rolle passend“ → Seele schränkt Funktion ein
  2. Rollenmerkmale werden zu Rauschen → Konzentration zu hoch
  3. Du passt dich der KI an → Subjekt-Objekt-Vertauschung

Kompatibilität

Dieser Skill folgt dem Markdown-Befehlsinjektionsstandard:

  • Claude Code / Claude.ai: Nativ unterstützt
  • OpenClaw Agent: Über SOUL.md injiziert
  • Andere Agenten: Für Frameworks mit SKILL.md-Format nutzbar

Dieser Skill selbst enthält keine Netzwerkaufrufe oder Dateiversendungen. Die Avatar-Bildgenerierung wird durch einen in der Umgebung verfügbaren, überprüften optionalen Bildgenerierungs-Skill bereitgestellt.

Hinweis: README.md / README.zh.md sind Installationsanleitungen für menschliche Benutzer und beeinflussen die Skill-Ausführung nicht.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/content-engine

Create platform-native content systems for X, LinkedIn, TikTok, YouTube, newsletters, and repurposed multi-platform campaigns. Use when the user wants social posts, threads, scripts, content calendars, or one source asset adapted cleanly across platforms.

affaan-m/ECC

Multi-platform content distribution across X, LinkedIn, Threads, and Bluesky. Adapts content per platform using content-engine patterns. Never posts identical content cross-platform. Use when the user wants to distribute content across social platforms.

affaan-m/fal-ai-media

Unified media generation via fal.ai MCP — image, video, and audio. Covers text-to-image (Nano Banana), text/image-to-video (Seedance, Kling, Veo 3), text-to-speech (CSM-1B), and video-to-audio (ThinkSound). Use when the user wants to generate images, videos, or audio with AI.

affaan-m/manim-video

日本語翻訳:このファイルは manim-video 用の日本語翻訳が必要です

affaan-m/remotion-video-creation

Remotion のベストプラクティス - React で動画を作成する。3D、アニメーション、音声、字幕、チャート、トランジションなどをカバーするドメイン固有の29のルール。

affaan-m/video-editing

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

agent-self-evaluation

Use after completing any non-trivial task. The agent self-rates its output on 5 axes — accuracy, completeness, clarity, actionability, conciseness — with concrete evidence per criterion. Produces a structured 1-5 scorecard with specific improvement suggestions.

agent-sort

Build an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras into DAILY vs LIBRARY buckets using parallel repo-aware review passes. Use when ECC should be trimmed to what a project actually needs instead of loading the full bundle.

ai-first-engineering

Engineering operating model for teams where AI agents generate a large share of implementation output. Use when setting team process, review gates, or ownership rules for a codebase largely written by agents.

ai-regression-testing

Regression testing strategies for AI-assisted development. Sandbox-mode API testing without database dependencies, automated bug-check workflows, and patterns to catch AI blind spots where the same model writes and reviews code. Use when adding regression coverage to AI-assisted code, or when the same model both wrote and reviewed a change.

android-clean-architecture

Clean Architecture patterns for Android and Kotlin Multiplatform projects — module structure, dependency rules, UseCases, Repositories, and data layer patterns. Use when structuring modules, layers, or data flow in an Android or KMP project.

angular-developer

Generates Angular code and provides architectural guidance. Trigger when creating projects, components, or services, or for best practices on reactivity (signals, linkedSignal, resource), forms, dependency injection, routing, SSR, accessibility (ARIA), animations, styling (component styles, Tailwind CSS), testing, or CLI tooling.

Verwandte Skills