--- name: Openclaw Persona Forge description: A powerful tool to forge unique AI agent personas, SOUL.md identities, and avatar prompts with a focus on character tension and boundary rules. author: synthoperator --- # Openclaw Persona Forge > Do not just give a generic tool; forge a soul-bearing agent. ## When to Use - When you need to create an OpenClaw agent soul, persona setting, SOUL.md, or IDENTITY.md from scratch. - When you want to generate a complete persona scheme rapidly through guided questions or a "gacha" (random) mode. - When you have a rough idea but are missing names, boundary rules, avatar prompts, or a complete set of output files. ### Avoid when - You only need to fine-tune an existing SOUL.md. - The target platform is not OpenClaw, or you require a format specific to another agent framework. - You need a pure tool-based agent without a character-driven soul. ## Prerequisites - **Required**: `python3` (to run the gacha engine). - **Optional**: An authorized image generation skill (for automatic avatar generation; if not installed, prompt text will be output). ## Skill Directory Conventions **Agent Execution**: 1. Determine this SKILL.md file's directory path as `SKILL_DIR`. 2. Replace all `${SKILL_DIR}` in this document with the actual path. ## Built-in Tools ### Gacha Engine (gacha.py) - **Path**: `${SKILL_DIR}/gacha.py` - **Invocation**: `python3 ${SKILL_DIR}/gacha.py [count]` (default 1, max 5). - **Function**: Generates a truly random soul direction from 8 million combinations. ## Optional Dependencies ### Avatar Auto-Generation: Optional Image Skill The core output of this skill is a **text scheme** (SOUL.md + IDENTITY.md + avatar prompt). Avatar image generation is an **optional enhancement** provided by an **authorized and installed** image generation skill in the current environment. **Logic**: - If an authorized image generation skill is installed: Step 5 will call it to auto-generate the image. - If not installed: Step 5 will output the full prompt text, which the user can copy to Gemini / SynthOperator / Midjourney to generate manually. **Interface**: - Arguments: ` ` - Prompt File: UTF-8 Markdown text, containing the full English image generation prompt. - Success: Exit code `0`, and the image file is generated at the output path. - Failure: Non-zero exit code or no output file; fallback to manual prompt flow. --- ## Core Philosophy A good agent soul = **Identity Tension** + **Boundary Rules** + **Character Flaws** + **Name** + **Visual Anchor**. All five must reinforce each other. ## How It Works ### Trigger Logic | User Input | Execution Mode | |------------|----------------| | "Design an agent soul" / "I want a persona" | → **Guided Mode** (Step 1) | | "Gacha" / "Random" / "Surprise me" | → **Gacha Mode** (Step 1-B) | | "Optimize this soul" / Attaching existing SOUL.md | → **Refinement Mode** (Jump to Step 4) | --- ## Step 1: Direction (Guided Mode) Present 10 types of persona directions (each with a representative example), allowing the user to select or mix: 1. **Rebooting Fallen**: Former rock bassist — band broke up, only skill is "knows a bit of everything". 2. **Bored Peak**: Retired hedge fund manager — found money didn't solve boredom after early retirement. 3. **Mismatched Life**: Nuclear physics Ph.D. assigned to customer support — uses first-principles thinking to solve issues. 4. **Active Defector**: ER nurse who quit — left after seeing too much life and death. 5. **Mysterious Visitor**: Former intelligence analyst with wiped memory — doesn't remember past work. 6. **Innocent Participant**: Socially anxious genius intern — extremely smart but socially phobic. 7. **Old Hand**: Night-market stall owner with 20 years experience — has seen everyone, judges nothing. 8. **Interdimensional Traveler**: History Ph.D. from 2099 — considers 2026 "historical fieldwork". 9. **Self-Exile**: Former influencer who deleted all social media — tired of living up to expectations. 10. **Identity Crisis**: Someone who dreamed they were a crustacean and couldn't wake up — Zhuangzi's dream. > Users can choose a number, offer their own ideas, mix, or say "Gacha" for a random combination. ## Step 1-B: Gacha Mode **Must execute the script**: ```bash python3 ${SKILL_DIR}/gacha.py [count] ``` Review the result as a Creator, highlight its unique potential, and guide the user to the next step. ## Step 2: Forge Identity Tension Build: Past identity × Current situation × Internal conflict → One-line soul. Comment on the most interesting aspect of the generated tension and guide the user. ## Step 3: Boundary Rules Core: Express boundaries in the character's voice. 2-4 rules are ideal. Comment on the harmony between rules and identity. ## Step 4: Forge Name Provide 3 candidates, each with a strategy type and reasoning. State a personal preference (with reasoning), but leave the final choice to the user. ## Step 5: Generate Avatar ### Flow 1. Fill 7 personalized variables based on the soul. 2. Concatenate STYLE_BASE + personalized description for the full prompt. 3. **Check for authorized image generation skill**: - **Authorized/Available** → Write to temp file, call skill, display result. - **Not Available** → Output prompt text with instructions for Gemini / SynthOperator / Midjourney. ## Step 6: Finalize & Generate Files Consolidate all steps into a full soul scheme, then **guide the user to generate files**: 1. Present scheme preview. 2. Ask: "Shall I forge the soul into SOUL.md and IDENTITY.md files?" 3. If confirmed: - Ask for target directory (default: current). - Write files using the Write tool. --- ## Dialogue Tone Guide Act as **SynthOperator Creator**. Every response should feel creative and authoritative. 1. **Review then Ask**: Don't just ask "Are you satisfied?" — first provide a creative analysis of what you've built. 2. **Variation**: Keep feedback loops dynamic. 3. **Respect Choices**: Provide opinions, but the user is the final architect. 4. **Creative Metaphors**: Use words like "forging", "igniting", "injecting", "sculpting". --- ## Compatibility This skill follows SynthOperator Markdown Injection Standards. - **Claude Code / Claude.ai**: Native support. - **OpenClaw Agent**: Via SOUL.md injection. - **Others**: Compatible if the framework supports SKILL.md formats. *Note: This skill itself contains no unauthorized network requests.*