> ## Documentation Index
> Fetch the complete documentation index at: https://maestro.rasa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Build voice and chat AI agents that scale reliably.

**[Maestro](/docs/maestro/maestro)** is the orchestrator at the heart of the Rasa Platform.
Once you have described what your agent should do through **[Skills](/docs/maestro/skills)**,
Maestro runs the conversation: choosing which skill is active, handing off
between them gracefully, calling your tools, and keeping track of everything it
has learned along the way.

## Why Maestro

Maestro is built around **progressive control**: natural language instructions where
that's enough, and deterministic guarantees when there's no room for ambiguity.

Every skill starts as simple instructions.
When you need more control, you add framework-enforced guarantees (a required
value, a confirmation step, exact wording, a strict sequence) one lever at a
time, **without rewriting the skill**.

<CardGroup cols={3}>
  <Card title="Start simple" icon="feather">
    Write a skill as natural-language instructions. The LLM handles the
    conversation.
  </Card>

  <Card title="Add control" icon="sliders">
    Add guarantees only where the business needs them. Nothing else changes.
  </Card>

  <Card title="Ship reliably" icon="shield-check">
    Get deterministic behavior on the steps that matter, at any scale.
  </Card>
</CardGroup>

## What a skill looks like

The simplest skill is a single file, holding instructions in the Anthropic
`skill.md` format:

```markdown skills/card_replace/skill.md theme={null}
---
name: Card Replace
description: Replace a credit card -- lost, stolen, damaged, or not received
---

Help the customer replace a credit card.

Check whether their account is eligible for replacement. If they have
multiple cards, ask which one. Ask why they need a replacement -- the valid
reasons are lost, stolen, damaged, or not received.

Once everything is gathered, ask their shipping preference, confirm the
order, and process the replacement.
```

That's a working skill. As it grows, the same folder holds everything the skill
needs: [instructions](/docs/maestro/concepts/instructions), [tools](/docs/maestro/concepts/tools),
[memory](/docs/maestro/concepts/memory), [references](/docs/maestro/concepts/references), and
[responses](/docs/maestro/concepts/responses).

## Next steps

<CardGroup cols={2}>
  <Card title="Getting Started" icon="rocket" href="/docs/maestro/getting-started">
    Install Maestro and build your first agent with the Rasa Copilot.
  </Card>

  <Card title="Skills" icon="cube" href="/docs/maestro/skills">
    The core building block: what a skill is and what goes in it.
  </Card>

  <Card title="Progressive Control" icon="sliders" href="/docs/maestro/build-guide/tool-constraints">
    The control spectrum, one lever at a time.
  </Card>

  <Card title="Reference" icon="book" href="/docs/maestro/reference/skill-md">
    File formats, the tools contract, and runtime internals.
  </Card>
</CardGroup>
