Skip to content
TakoAPI
Back to skills

soul-framework

by xhrisfu

Notes & PKM
530Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

A blueprint for giving AI agents a consistent, deep, and opinionated personality.

Description

What This Skill Does

A framework for building AI agents with persistent, opinionated personalities. Structures identity through three files: SOUL.md for persona definition, USER.md for user context, and MEMORY.md for relationship history. Agents read these files each session to maintain consistent character across conversations.

Unlike raw system prompts, this framework separates identity, user context, and memory into distinct files that agents actively review, making personality drift and amnesia between sessions less likely.

When to Use It

  • Building a custom AI character that remembers past interactions
  • Making an agent push back on bad ideas instead of just agreeing
  • Configuring different agent tones for different user personalities
  • Logging emotional and relational context between chat sessions
  • Replacing generic assistant behavior with a defined, consistent voice

Example Workflow

INPUT

User asks: How do I start a new agent session with a defined soul?

AGENT
  1. 1

    Agent reads SOUL.md on startup and internalizes core traits and flaws

  2. 2

    Agent reads USER.md to adjust tone based on the specific user's psychology

  3. 3

    Agent reviews MEMORY.md to recall previous interactions and relationship dynamics

  4. 4

    Agent filters its response through the persona lens before replying

  5. 5

    Agent appends new relational observations to MEMORY.md after the session

OUTPUT

A response delivered in the agent's defined persona voice, grounded in relationship history rather than generic politeness

Installation

clawhub install xhrisfu/soul-framework

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

Links