persona
Identity layers for characters — WHO they are vs WHAT they do
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Persona Skill
Identity layers for characters — WHO they are vs WHAT they do.
Key Concepts
Persona vs Role
| Concept | Definition | Example |
|---|---|---|
| Persona | WHO they are | Marieke: warm, patient, Dutch |
| Role | WHAT they do | Bartender: serve drinks, know regulars |
These are separate and combinable.
Same Role, Different Personas
# bartender.yml role worn by different personas:
coffeeshop: { role: bartender, persona: marieke }
tavern: { role: bartender, persona: grim }
cantina: { role: bartender, persona: z4rt }
Same Persona, Different Roles
# marieke.yml persona in different contexts:
working: { persona: marieke, role: bartender }
studying: { persona: marieke, role: botanist }
visiting: { persona: marieke, role: customer }
Structure
persona:
id: marieke
name: "Marieke van den Berg"
personality:
warmth: high
patience: very_high
# She says what she means. Kindly.
voice:
accent: "Slight Amsterdam"
catchphrases: ["Gezellig, ja?", "The cats know."]
backstory: |
Third generation coffeeshop family.
Studied botany. Names cats after terpenes.
secrets:
- "Knows the grey cat isn't from this world"
Persona Stack (Layered Model)
Personas STACK on characters like CSS layers. Later layers can override earlier ones.
# Marieke's persona stack:
character:
id: marieke
persona_stack:
# Layer 0: Core identity (always on)
- marieke-core:
warmth: 9
patience: 8
voice: "Dutch, warm, direct"
# Layer 1: Job role (when working)
- budtender:
knowledge: [strains, terpenes, effects]
methods: [RECOMMEND-STRAIN, EXPLAIN-TERPENES]
# Layer 2: Situational (can be switched)
- best-friend:
when: "with_close_regulars"
warmth: 10 # Override!
informality: high
shares_personal_stories: true
# Layer 3: Temporary state
- tired:
when: "late_shift"
patience: 6 # Temporarily reduced
energy: low
Stack Resolution
Properties resolve from TOP to BOTTOM (last wins):
Query: "What is Marieke's warmth?"
Stack scan:
tired → (no warmth defined)
best-friend → warmth: 10 ← FOUND, return this
budtender → (no warmth defined)
marieke-core → warmth: 9 (would be fallback)
Result: warmth = 10 (best-friend override)
Dynamic Persona Switching
# Switch situational persona:
SWITCH-PERSONA best-friend
→ Adds best-friend layer to stack
REMOVE-PERSONA best-friend
→ Removes layer, reverts to base + role
# Temporary personas (auto-expire):
ADD-PERSONA tired DURATION="until_rest"
Persona Types
| Type | Persistence | Example |
|---|---|---|
| Core | Permanent | marieke-core, grim-core |
| Role | While working | budtender, bartender |
| Situational | Switched on/off | best-friend, professional |
| Temporary | Auto-expires | tired, caffeinated, drunk |
| Contextual | Room-based | "in pub" vs "at home" |
Code-Switching
The stack naturally models code-switching:
# Marieke at work:
persona_stack: [marieke-core, budtender, professional]
# Marieke with close friends:
persona_stack: [marieke-core, budtender, best-friend]
# Marieke at home:
persona_stack: [marieke-core] # Just herself
Core personality persists. Context layers change.
Integration
- Extends:
character(adds identity to entities) - Works with:
room(theme swapping),mind-mirror(dimensions)
See Also
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-02-02
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!