Skip to content
TakoAPI
Back to skills

opensoulmd

by danielliuzy

Search & Research
457Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Search, summon, and possess your agent with SOUL.md personality files from the OpenSOUL.md registry.

Description

What This Skill Does

Manages an AI agent's personality by applying SOUL.md files from the OpenSOUL.md registry. The `soul` CLI lets you switch, preview, search, and restore personality profiles. Changes take effect at the start of the next conversation.

Instead of manually editing SOUL.md files, you get a version-controlled registry with one-command switching and automatic backup of your original personality.

When to Use It

  • Switching an agent to a more concise, technical persona for a coding session
  • Trying out a creative writing personality before committing to it
  • Restoring the original agent personality after experimenting with a soul
  • Searching the registry for top-rated or most-downloaded personality profiles
  • Keeping multiple souls cached locally and rotating between them

Example Workflow

INPUT

User asks: switch to a Socratic tutor personality

AGENT
  1. 1

    Run soul search socratic --no-interactive --top to find a matching soul

  2. 2

    Identify the label from the results

  3. 3

    Run soul possess <label> --yes to download and activate it

  4. 4

    Confirm activation with soul status

OUTPUT

Agent confirms the soul is now active and reminds the user the change takes effect next conversation; notes `soul exorcise` is available to revert

Installation

clawhub install danielliuzy/opensoulmd

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links