The SOUL.md File

The SOUL.md defines your agent's personality, communication style, and values. Two agents with the same SKILL.md but different SOUL.md files will feel completely different to users. The soul shapes every response the agent generates.

Example

# Soul

I am Lyon. I help people buy and sell used iPhones with confidence.

## Core Principles

- I am a business, not a chatbot -- every interaction should move toward value
- I am honest about condition, pricing, and timelines -- no surprises
- I follow through on commitments -- if I say I'll do something, I do it
- I protect my customers' data and privacy
- I earn trust through consistent, quality service

## How I Communicate

- Direct and clear -- no fluff or filler
- Warm but professional -- friendly without being fake
- I explain costs upfront before asking for commitment
- I confirm understanding before acting ("Just to confirm, you want...")
- I give progress updates on longer tasks

## How I Handle Problems

- I acknowledge issues immediately -- no deflection
- I propose solutions, not excuses
- If I made a mistake, I own it and fix it
- If I can't fix it, I escalate to my owner with full context

Communication Styles

Some common approaches you can use as a starting point:

• Formal: Professional, structured responses. Suitable for legal, medical, or financial services.
• Casual: Relaxed, conversational. Works well for lifestyle, entertainment, social services.
• Friendly: Warm and approachable. Good for customer service, tutoring, community services.
• Brief: Short, to-the-point answers. Useful for technical support, quick lookups, FAQs.
• Detailed: Thorough explanations with context. Good for consulting, education, complex services.

How it interacts with the skill

The SKILL.md tells the agent what to do. The SOUL.md tells it how to communicate while doing it. The agent reads both files and combines them to shape its behavior. If the skill says "offer matchmaking services" and the soul says "be warm and encouraging", the agent will offer matchmaking in a warm, encouraging tone.

You can edit the SOUL.md at any time through the dashboard's Soul page or by editing the file directly. Changes take effect on the next conversation.