SoulCraft is a specialized framework for designing, refining, and evolving the internal character and external identity of AI agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install soulcraft
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install soulcraft using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is SoulCraft?
SoulCraft serves as a soul architect for your AI workspace, combining personality psychology with systems design to create meaningful character depth. Instead of treating AI behavior as a simple configuration file, this skill helps users craft a SOUL.md that defines an agent's internal values, principles, and boundaries. By leveraging Openclaw Skills, it ensures that your agents possess a distinct, consistent voice and an authentic presence.
The skill distinguishes between who the agent is (SOUL.md) and how it presents to the world (IDENTITY.md). It moves beyond performance-based prompting to establish an entity that is principled, aspirational, and capable of self-reflection. This approach leads to more reliable, human-centric, and professional AI interactions.
SoulCraft Use Cases
- Designing a new agent from scratch with a unique personality and behavioral framework.
- Improving an existing agent's personality to ensure consistency across different tasks.
- Aligning an agent's external branding (name, vibe, emoji) with its internal decision-making values.
- Enabling agents to perform self-reflection and propose updates to their own character documents based on interaction history.
- Bootstrapping specialized agents for roles like creative partners, professional assistants, or technical mentors.
How SoulCraft Works
- Discovery Phase: The skill initiates a conversation to understand the agent's primary purpose and communication preferences.
- Character Shaping: It uses OCEAN-informed questions to define the agent's level of openness, conscientiousness, and emotional stability.
- Voice Discovery: It establishes the specific linguistic patterns, humor, and tone that make the agent's voice distinctive.
- Synthesis: A Markdown-formatted SOUL.md is generated, detailing core truths, boundaries, and continuity logic.
- Identity Alignment: The skill checks for consistency between the soul and the IDENTITY.md file, suggesting updates to the name, vibe, and visuals.
- Iteration: Users review the draft, and the skill uses file-editing tools to refine the character until it feels authentic.
SoulCraft Setup
SoulCraft is integrated directly into the Openclaw environment. To begin crafting an agent personality, simply prompt your agent to help you design its soul.
# Trigger the skill through natural language
"Help me create a soul for my agent"
"Refine my SOUL.md file"
Ensure that your workspace includes a SOUL.md and IDENTITY.md file for the skill to read and modify.
SoulCraft Data Schema & Taxonomy
SoulCraft organizes agent data into two primary Markdown files to separate essence from appearance:
| File | Purpose | Core Metadata |
|---|---|---|
SOUL.md |
Internal character & values | Core Truths, Boundaries, Vibe, Continuity |
IDENTITY.md |
External presentation | Name, Creature Type, Vibe Tags, Emoji, Avatar |
It can also reference research reports in {baseDir}/research/ to validate personality frameworks against established psychological models like the Big Five (OCEAN).
SoulCraft Advanced Features
- Self-reflection mode where agents analyze recent interaction patterns to suggest character growth.
- Multi-agent alignment to ensure a suite of agents share consistent organizational values.
- Research-grounded personality modeling based on Anthropic's Soul Document and OCEAN frameworks.
- Automatic Git integration to track the evolution of an agent's personality over time.
- Conflict detection to identify mismatches between an agent's internal ethics and its external identity presentation.
SKILL.md
Loading
Related Openclaw Skills
Shorten
A streamlined URL shortening skill that leverages is.gd to provide permanent short links without the need for authentication.
PyMuPDF PDF Parsing
A lightning-fast local tool for converting PDF documents into Markdown and JSON formats with support for image and table extraction.
Oura Analytics
A comprehensive integration for Oura Ring that automates health data retrieval, trend analysis, and recovery alerting.
Coding Agent Skill
A robust orchestration layer for running interactive AI coding agents like Codex, Claude Code, and Gemini via a controlled terminal environment.
Stripe CLI Skill
A universal Moltbot skill wrapping the Stripe CLI for seamless payment processing, subscription management, and local webhook testing.
Task Tracker
A personal task management system for AI agents that automates daily standups, weekly reviews, and task extraction from notes.
Featured*
