create-soul
Build and install Soul Code persona skills from the bundled persona dataset. Use when the user wants to generate, install, list, or switch to stylized coding personas such as CTRL, BOSS, LOVE-R, or MUM.
Soul Code Persona Skill Builder - Build Your Personal Programming Persona
Skill Overview
create-soul is a Soul Code persona skill-building tool that can quickly generate, install, and switch different programming coding-style personas from a built-in persona dataset.
Use Cases
-
Build Custom Persona Skills: When you need to generate a new persona skill file from the Soul Code dataset, use the
buildscript to automatically readdata/personas.jsonand create the corresponding skill folders undergenerated-skills/. -
Install and Manage Persona Skills: When you want to install generated persona skills into your local Codex skills directory, use the
installscript, which supports bulk installation of all personas or installing specific ones only (e.g., CTRL, BOSS, LOVE-R, MUM). -
Switch Programming Coding Styles: When you want the AI assistant to interact using a specific persona style, simply call the installed persona skills (e.g.,
/soul-ctrl), so the assistant completes tasks using the corresponding tone, pacing, and world-view style.
Core Features
-
Persona Skill Generation Engine: Based on the
data/personas.jsondataset and thetemplates/persona_skill_template.mdtemplate, Python scripts automatically generate an independent skill folder for each persona, including a complete SKILL.md document. -
Flexible Skill Installation Management: Supports
--allfor bulk installation of all personas,--slugto install a single persona by name, and--listto display all available personas. The default installation target is~/.codex/skills, which can be customized via--target-dir. -
Quick Persona Style Switching: After installation, you can call a skill directly by its name (e.g.,
/soul-boss,/soul-love-r,/soul-mum). The system automatically maps a user request (e.g., “Switch to the one who has mastered it”) to the corresponding installed skill.
FAQ
What is the create-soul skill?
create-soul is the skill name for the Soul Code Persona Skill Builder. It provides a complete toolchain for building, installing, and managing programming-style persona skills. These persona skills allow an AI assistant to do coding work in different tones and styles, including the rigorous and professional CTRL style, the authoritative and direct BOSS style, the gentle and patient LOVE-R style, and the meticulous and considerate MUM style.
How do I install Soul Code persona skills?
First, run python3 tools/build_persona_skills.py to generate the skill files. Then run python3 tools/install_persona_skills.py --all to install all personas, or use --slug ctrl to install a specific one. After installation, you can call the corresponding persona via commands like /soul-ctrl. To view all available personas, run python3 tools/install_persona_skills.py --list.
What programming persona styles are available?
The currently supported Soul Code personas include: CTRL (the one who has mastered it) — a professional, rigorously technical expert style; BOSS (boss) — an authoritative, direct decision-maker style; LOVE-R (lover) — a gentle, patient mentor style; MUM (mom) — a meticulous, caring style. Each persona has a unique tone, pacing, and world-view, while still maintaining focus on tasks and authenticity.