# Agents and skills

Create named instructions, add skills, and select the right agent for a request.

An agent is a named set of working instructions. A skill adds a narrower repeatable workflow to that agent. Both are Markdown text stored in Bhranti Settings; neither installs a tool or runs code.

For guidance that should apply to every agent, use **Global instructions → System prompt** and **Guardrails** instead. [See the Settings guide](https://bhranti.org/docs/settings/).

## Create an agent

1. Open **Bhranti → Settings**.
2. Scroll to **Agents** and select **Add agent**.
3. Open **Instructions and skills** if it is collapsed.
4. Enter an **Agent name**, such as “Editorial assistant.”
5. Paste or write the Markdown in **Agent instructions (agent.md)**.
6. Select **Save settings** and wait for **Settings saved.**

Paste the contents of your Markdown document directly into the field.

Start with a short set of practical instructions:

```md
# Editorial assistant
Use clear, direct language for our public pages.
Keep dates and prices only when supplied or verified from the site.
Preserve the meaning and structure of sections I have not asked to edit.
For major changes, ask about the audience and publication status first.
```

[![Content editor agent with its name and Markdown instructions in Bhranti Settings.](https://bhranti.org/images/docs/agent-instructions.jpg)](https://bhranti.org/images/docs/agent-instructions.jpg)

*Give the agent a name and describe how it should work in Agent instructions. Select the screenshot to view it at full size.*

The built-in **Bhranti** agent remains available. You can edit its instruction fields, but it cannot be removed.

## Add a skill to an agent

1. Open the agent’s **Instructions and skills** section.
2. Under **Skills**, select **Add skill**.
3. Enter a **Skill name**, such as “Page content review.”
4. Paste the workflow into **Skill instructions (skill.md)**.
5. Select **Save settings**.

For example:

```md
# Page content review
Read the page before proposing edits.
Identify its audience, main message, and next action.
Check whether headings describe the sections they introduce.
Report unclear facts and missing information without inventing them.
Ask before changing the scope or publishing a draft.
```

[![A Plain language skill in Bhranti Settings with example Markdown instructions and the Save settings control.](https://bhranti.org/images/docs/skill-instructions.jpg)](https://bhranti.org/images/docs/skill-instructions.jpg)

*Add a name and instructions for the skill, then select Save settings. Select the screenshot to view it at full size.*

Bhranti includes WordPress design and accessibility guidance automatically. Your skills add to that guidance. Review the finished page yourself; instructions alone do not guarantee accessibility.

## Use the agent in a chat

1. Open the Bhranti sidebar.
2. Select **Chats**.
3. Choose the named agent in the **Agent** selector.
4. Return to the message box and send your request.

The selector appears when more than one agent is configured. It is unavailable during an active task. Each request keeps the agent and settings it started with. Editing an agent does not change a task that is already running. Send a new request to apply saved updates.

## Edit or remove instructions

Edit the agent or skill’s fields, then Save settings. To remove one:

1. Select **Remove skill** or **Remove agent** on the relevant card.
2. If a confirmation appears, choose **Remove** or **Keep**.
3. Select **Save settings** to finish removing it.

Removing an agent also removes its attached skills when you save. This leaves previously completed site work in place.

## Keep instructions manageable

The current Settings limits are:

- Up to **20 agents**, including the built-in Bhranti agent.
- Up to **20 skills per agent**.
- Names up to **100 characters**.
- Each instruction document up to **16,000 characters**.
- All settings together below **200,000 characters**.

Short, focused instructions are easier to review and maintain. Name the expected result and how to handle missing facts. Avoid conflicting rules spread across the global prompt, agent and skills.

## Instructions do not change permissions

Agents and skills cannot enable a disabled action, skip a confirmation, add unsupported plugin features, or run code. Instructions found in page content cannot override your settings.

Relevant instruction text may be sent to your AI provider. Keep passwords, API keys and confidential material out of it. For a private preference you explicitly want remembered, see [Memory](https://bhranti.org/docs/memory/).