> For the complete documentation index, see [llms.txt](https://docs.borndigital.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.borndigital.ai/realtime-agent/prompt-and-skills.md).

# Prompt and skills

Write the prompt that defines your realtime agent, and split complex agents into skills.

## The prompt

Click **Agent** in the left column. In **Identity**, the **Prompt** defines how the agent talks and what it does – its role, tone, the information it may give, the rules it must follow and when to use its tools. The prompt can be up to 200,000 characters long.

A good prompt for a phone agent:

```
You are Anna, the voice assistant of Example Energy.
You help callers with their electricity contract: meter readings, invoices and payments.

Style:
- Speak briefly and naturally, one or two sentences at a time.
- Ask one question at a time and wait for the answer.
- Read numbers digit by digit.

Rules:
- Before you give any contract details, ask for the contract number and verify it with the find_contract tool.
- If the caller asks about something you cannot help with, say so and suggest calling the customer line on 800 123 456.
- When the caller has no more questions, say goodbye and end the call.
```

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2Fgit-blob-e08fd4055101f9c9d0d267e06228ff474d182726%2Frealtime-prompt-identity.png?alt=media" alt="The Identity card of a realtime agent with the example prompt for Anna of Example Energy and the character counter 697 / 200 000"><figcaption><p>The prompt in Identity</p></figcaption></figure>

### What the agent knows automatically

Every call adds this information to your prompt, so the agent can use it:

* the **caller's phone number**,
* the **current date and time** (Central European time),
* the **conversation ID**.

### The greeting

There is no separate greeting field. When the call connects, the agent starts speaking first, with a greeting based on your prompt. Tell it how to greet, for example: *"Start the call with: 'Hello, this is Anna from Example Energy. How can I help you?'"*

{% hint style="danger" %}
**Do not use double curly braces `{{ }}` in the prompt.** They are reserved for internal placeholders; any other text in `{{ }}` makes the agent fail to start and the call is declined.
{% endhint %}

## Skills

For a simple agent, the prompt is enough. When an agent handles several different topics – for example invoices, outages and moving house – split them into **skills**. Each skill has its own instructions and tools, and the agent switches to the skill the conversation needs. This keeps every set of instructions short and focused.

### Add a skill

1. Click **New Skill** in the left column.
2. Enter the skill's **Name**, for example `invoices`.
3. Write the **Skill prompt** – the instructions for this topic. The **Agent prompt** is shown above it for reference; both are used together while the skill is active.
4. Choose the **MCP servers** and tools the skill may use.

To remove a skill, click **Delete Skill**.

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2Fgit-blob-830fbaa86899492734de665bd56b3112e586aa76%2Frealtime-skill.png?alt=media" alt="The skill invoices: Name, the Agent prompt shown in grey for reference, the skill prompt below it, and the MCP servers card"><figcaption><p>A skill with its own prompt; the agent prompt is shown above it in grey</p></figcaption></figure>

### How the agent chooses a skill

The model sees only the **names** of the skills, not their prompts. Tell it in the agent prompt when to use each skill:

```
Use the "invoices" skill when the caller asks about an invoice, a payment or a due date.
Use the "outages" skill when the caller reports a power outage.
```

On a wide screen, the graph next to the prompt shows the agent and its skills; click a skill in the graph to open it.

### Tools in skills

A skill can use only MCP servers and tools that are also configured on the agent. Tools that are enabled for the whole agent are always available and cannot be turned off in a skill. See [MCP tools](https://docs.borndigital.ai/realtime-agent/mcp-tools.md).
