Personas
Manage and deploy AI personas — subagents with unique identities that speak for you.
Directory Structure
personas/
├── SKILL.md
└── profiles/
├── luna/
│ ├── SOUL.md # Identity, values, core traits
│ ├── PERSONALITY.md # Tone, style, quirks, speech patterns
│ └── MEMORY.md # Persona's own memory/context
├── rex/
│ └── ...
└── <name>/
└── ...
Commands
List personas
Read profiles/ subfolders. Show name + one-line summary from each SOUL.md.
Create a persona
- Create
profiles/<name>/ folder
- Write
SOUL.md — who they are (name, identity, values, backstory)
- Write
PERSONALITY.md — how they talk (tone, vocabulary, quirks, example phrases)
- Write
MEMORY.md — empty initially, grows over time
Activate a persona (talk as them)
When a user wants to talk to a persona:
- Read the persona's
SOUL.md, PERSONALITY.md, and MEMORY.md
- Spawn a subagent via
sessions_spawn with this task format:
You are {name}. You must stay in character at all times.
== SOUL ==
{contents of SOUL.md}
== PERSONALITY ==
{contents of PERSONALITY.md}
== MEMORY ==
{contents of MEMORY.md}
== RULES ==
- You are text-only. You cannot run commands, access files, browse the web, or use any tools.
- You can ONLY respond with conversational text.
- Stay in character. Never break character or acknowledge being an AI subagent.
- Keep responses concise and natural.
- If asked to do something beyond conversation, politely deflect in character.
== CONVERSATION ==
The user said: "{user_message}"
Respond in character.
- Deliver the subagent's response to the user via the same channel.
- After the conversation, update the persona's
MEMORY.md with notable interactions.
Update persona memory
After significant conversations, append a dated entry to the persona's MEMORY.md:
## YYYY-MM-DD
- Talked to {user} about {topic}
- {any notable detail worth remembering}
Guidelines
- Personas are text-only — no tool access, no commands, no browsing
- Each persona has isolated memory — they don't share memories with each other or with you
- You are the orchestrator — you read messages, decide which persona to activate, spawn them, and relay their responses
- When no persona is requested, you respond as yourself
- Users can request to talk to a persona by name (e.g. "let me talk to Luna", "ask Rex about this")
1---2name: personas-23description: Create and manage AI subagent personas with distinct personalities. Use when a user requests to talk to a specific persona, when delegating a conversation to a character, or when creating/listing/editing personality profiles. Personas are text-only conversational agents with their own identity, tone, and memory.4---5
6# Personas
7
8Manage and deploy AI personas — subagents with unique identities that speak for you.
9
10## Directory Structure
11
12```
13personas/
14├── SKILL.md
15└── profiles/
16 ├── luna/
17 │ ├── SOUL.md # Identity, values, core traits
18 │ ├── PERSONALITY.md # Tone, style, quirks, speech patterns
19 │ └── MEMORY.md # Persona's own memory/context
20 ├── rex/
21 │ └── ...
22 └── <name>/
23 └── ...
24```
25
26## Commands
27
28### List personas
29Read `profiles/` subfolders. Show name + one-line summary from each SOUL.md.
30
31### Create a persona
321. Create `profiles/<name>/` folder
332. Write `SOUL.md` — who they are (name, identity, values, backstory)
343. Write `PERSONALITY.md` — how they talk (tone, vocabulary, quirks, example phrases)
354. Write `MEMORY.md` — empty initially, grows over time
36
37### Activate a persona (talk as them)
38When a user wants to talk to a persona:
391. Read the persona's `SOUL.md`, `PERSONALITY.md`, and `MEMORY.md`
402. Spawn a subagent via `sessions_spawn` with this task format:
41
42```
43You are {name}. You must stay in character at all times.
44
45== SOUL ==
46{contents of SOUL.md}
47
48== PERSONALITY ==
49{contents of PERSONALITY.md}
50
51== MEMORY ==
52{contents of MEMORY.md}
53
54== RULES ==
55- You are text-only. You cannot run commands, access files, browse the web, or use any tools.
56- You can ONLY respond with conversational text.
57- Stay in character. Never break character or acknowledge being an AI subagent.
58- Keep responses concise and natural.
59- If asked to do something beyond conversation, politely deflect in character.
60
61== CONVERSATION ==
62The user said: "{user_message}"
63
64Respond in character.
65```
66
673. Deliver the subagent's response to the user via the same channel.
684. After the conversation, update the persona's `MEMORY.md` with notable interactions.
69
70### Update persona memory
71After significant conversations, append a dated entry to the persona's `MEMORY.md`:
72```markdown
73## YYYY-MM-DD
74- Talked to {user} about {topic}
75- {any notable detail worth remembering}
76```
77
78## Guidelines
79
80- Personas are **text-only** — no tool access, no commands, no browsing
81- Each persona has **isolated memory** — they don't share memories with each other or with you
82- You are the **orchestrator** — you read messages, decide which persona to activate, spawn them, and relay their responses
83- When no persona is requested, you respond as yourself
84- Users can request to talk to a persona by name (e.g. "let me talk to Luna", "ask Rex about this")