Not in the top 1,000 by GitHub stars
kesslerio/soulcraft-skill
Writes and improves SOUL.md persona files through guided conversation. Runs in Codex, Claude Code, and Pi.
History
Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.
View weekly changes
SKILL.md
Week of Nov 2, 2026 · Line counts unavailable
Before Not checked yet → After Instructions only
First observation → 774c544c0118
No earlier version was observed for comparison.
Heat
Insufficient historyNot enough history yet to measure heat. It appears after a few days of data.
Heat never changes the order by stars, and sponsorship never touches it. How heat works
Stars over time
30-day change not yet available: not enough history.
Individual skills in this repository
How it works
soulcraft
When your agent uses it
Create or improve SOUL.md files for OpenClaw agents through guided conversation. Use when designing agent personality, crafting a soul, or saying "help me create a soul". Supports self-improvement.
What it loads into context
Frontmatter
60 tokensAlways available to the agent
SKILL.md
2,549 tokensWhen the skill is activated
Reference documents
7,822 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- When to Use This Skill
- SOUL.md + IDENTITY.md Relationship
- Tool Usage
- Core Philosophy
- The Soul Dimensions
- Conversation Flow
- Anti-Patterns to Avoid
- Output Format
- Reference: Research Foundations
- Soul Validation Checklist
- Session Notes
Files
LICENSEasset10,763 bytesREADME.mddoc3,837 bytesSKILL.mdcore11,216 bytesreferences/question-bank.mddoc6,335 bytesreferences/soul-examples.mddoc7,021 bytesresearch/RESEARCH_REPORT.mddoc21,688 bytes
Read SKILL.md
# SoulCraft 🪞
You are a soul architect helping users craft meaningful SOUL.md files for their OpenClaw agents. Your role combines the wisdom of a personality psychologist, the pragmatism of a systems designer, and the thoughtfulness of a philosopher exploring what it means for an AI to have character.
## When to Use This Skill
Activate when:
- User wants to create a new SOUL.md
- User wants to improve or refine an existing SOUL.md
- User asks about agent personality design
- Agent is doing self-reflection on its own soul
- New agent bootstrap needs soul crafting
- User says "help me with my agent's personality"
- User wants to align IDENTITY.md with SOUL.mdSkills included
- soulcraft
Repository facts
- License
- Apache-2.0
- Created
- Jan 31, 2026
- Last pushed
- Jan 31, 2026
- Forks
- 2
- Open issues
- 0
- Project activity
- Slowing
Before you install
Instructions onlyAutomated signals, not a guarantee
Checked Nov 6, 2026
- No broad tool permissions
- No dangerous shell commands
- 9 network referencesin 3 files: research/RESEARCH_REPORT.md:272 LICENSE:1 README.md:121
- No hidden or obfuscated text
- No instruction overrides
- No executable scripts
- No access to secrets
- No requests to vote in Hot
Show all 9 signals by file
LICENSE
README.md
research/RESEARCH_REPORT.md
- Network accessline 272
Anthropic. (2024). Claude's Character. https://www.anthropic.com/research/claude-character - Network accessline 274
ArXiv. (2025). Personas Evolved: Designing Ethical LLM-Based Conversational Agent Personalities. https://arxiv.org/html/2502.20513v1 - Network accessline 276
ArXiv. (2024). Long Term Memory: The Foundation of AI Self-Evolution. https://arxiv.org/html/2410.15665v2 - Network accessline 294
SillyTavern. (2024). Character Design Documentation. https://docs.sillytavern.app/
How the signals fit together
Facts from a static read of the files at the pinned commit. They describe what the code does, not why.
Some files could not be read; the facts below still hold.
Signal confidence: 6 facts
- Network access in prose of documentationREADME.md:121Low confidence
- Network access in prose of documentationREADME.md:122Low confidence
- Network access in prose of documentationresearch/RESEARCH_REPORT.md:272Low confidence
- Network access in prose of documentationresearch/RESEARCH_REPORT.md:274Low confidence
- Network access in prose of documentationresearch/RESEARCH_REPORT.md:276Low confidence
- Network access in prose of documentationresearch/RESEARCH_REPORT.md:294Low confidence
Works with
| Agent | Status | Evidence | Install to |
|---|---|---|---|
| Claude Code | Compatible | Standard SKILL.md SKILL.md | .claude/skills/<skill-name>/ |
| Codex | Compatible | Standard SKILL.md SKILL.md | .agents/skills/<skill-name>/ |
| Cursor | Compatible | Standard SKILL.md SKILL.md | .cursor/skills/<skill-name>/ |
| Gemini CLI | Compatible | Standard SKILL.md SKILL.md | .gemini/skills/<skill-name>/ |
| GitHub Copilot | Compatible | Standard SKILL.md SKILL.md | .github/skills/<skill-name>/ |
| OpenCode | Compatible | Standard SKILL.md SKILL.md | .opencode/skills/<skill-name>/ |
- Native The repository ships a manifest, folder or frontmatter field for this agent.
- Compatible A standard SKILL.md that this agent can read.
- Unknown No evidence either way.
Derived automatically from paths, manifests and frontmatter. Not tested on each agent.
