> ## Documentation Index
> Fetch the complete documentation index at: https://www.bolna.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Bolna Skills

> Teach your AI coding assistant to build, deploy, and operate Bolna voice agents using Agent Skills.

## What are Bolna Skills?

Bolna Skills are a set of structured instructions that teach AI coding assistants — such as **Claude Code**, **Cursor**, **Codex**, and others that support the [Agent Skills](https://agentskills.io) format — how to work with the Bolna platform.

Once installed, your AI assistant can create agents, make calls, run batch campaigns, set up inbound numbers, debug issues, and more — all from natural language prompts inside your editor or terminal.

<CardGroup cols={3}>
  <Card title="Build Agents" icon="robot">
    Create and configure voice agents with prompts, voices, and tools
  </Card>

  <Card title="Make Calls" icon="phone">
    Place outbound calls, run batch campaigns, and set up inbound numbers
  </Card>

  <Card title="Monitor & Debug" icon="chart-mixed">
    Pull transcripts, set up webhooks, extract data, and troubleshoot calls
  </Card>
</CardGroup>

***

## Installation

Install Bolna Skills in your project with a single command:

```bash theme={"system"}
npx skills add bolna-ai/skills
```

To install for a specific AI assistant:

```bash theme={"system"}
npx skills add bolna-ai/skills -a claude-code
npx skills add bolna-ai/skills -a cursor
npx skills add bolna-ai/skills -a codex
```

To install only a specific skill:

```bash theme={"system"}
npx skills add bolna-ai/skills --skill create-agent
```

***

## Setup

Get your API key from the [Bolna Dashboard → Developers](https://platform.bolna.ai) and export it:

```bash theme={"system"}
export BOLNA_API_KEY="your-api-key"
```

You can also add it to a `.env` file in your project:

```bash theme={"system"}
BOLNA_API_KEY=your-api-key
```

<Warning>
  Make sure `.env` is listed in your `.gitignore` to avoid committing secrets.
</Warning>

***

## Usage

Once installed, just ask your AI assistant what you need in plain English. The right skill loads automatically based on your request.

### Example prompts

<AccordionGroup>
  <Accordion title="Create an agent" icon="robot">
    ```
    Create a Hindi voice agent for appointment booking using Plivo and Sarvam.
    ```

    Uses the `create-agent` skill — configures LLM, TTS, STT, telephony, and system prompt in one shot.
  </Accordion>

  <Accordion title="Make a test call" icon="phone-arrow-up-right">
    ```
    Place a test call to +91XXXXXXXXXX and pass customer_name: Priya as user_data.
    ```

    Uses the `make-call` skill — places an outbound call with dynamic variables.
  </Accordion>

  <Accordion title="Run a batch campaign" icon="list-check">
    ```
    Upload leads.csv as a Bolna batch campaign and monitor it until done.
    ```

    Uses the `create-batch` skill — creates a CSV-driven campaign with scheduling and monitoring.
  </Accordion>

  <Accordion title="Debug a call" icon="bug">
    ```
    My Bolna call has a long silence before each response — debug it.
    ```

    Uses the `debug-bolna-calls` skill — runs a symptom-to-fix diagnostic using execution logs.
  </Accordion>

  <Accordion title="Build a graph agent" icon="diagram-project">
    ```
    Build a graph agent for payment confirmation with real-time event injection.
    ```

    Uses the `bolna-graph-agents` skill — creates node-based call flows with deterministic routing.
  </Accordion>

  <Accordion title="Set up inbound IVR" icon="phone-arrow-down-left">
    ```
    Set up an inbound IVR that routes sales, support, and billing to three different agents.
    ```

    Uses the `setup-inbound` skill — wires phone numbers to agents with IVR menus and caller identification.
  </Accordion>
</AccordionGroup>

***

## Available Skills

### Build agents

| Skill            | Description                                                                                                  |
| ---------------- | ------------------------------------------------------------------------------------------------------------ |
| `setup-api-key`  | Generate, store, and verify your `BOLNA_API_KEY`                                                             |
| `add-provider`   | Bring your own OpenAI, Anthropic, Azure, ElevenLabs, Deepgram, Twilio, Plivo, and other provider credentials |
| `create-agent`   | Create a voice agent end-to-end — LLM, voice, transcriber, telephony, knowledge bases, and function tools    |
| `manage-agents`  | List, update, delete, or stop queued calls for an agent                                                      |
| `prompt-writing` | Author production voice prompts with sectioned structure, multilingual entries, and FAQ in YAML              |

### Make calls

| Skill                  | Description                                                                                         |
| ---------------------- | --------------------------------------------------------------------------------------------------- |
| `make-call`            | Place a single outbound call — immediate or scheduled, with dynamic variables and auto-retry        |
| `create-batch`         | Run CSV-driven outbound campaigns at scale with scheduling and monitoring                           |
| `setup-inbound`        | Wire phone numbers to agents with IVR menus, caller identification, and multilingual auto-switching |
| `manage-phone-numbers` | Search and buy US or India phone numbers                                                            |
| `setup-sip-trunk`      | Bring your own SIP trunk — Twilio Elastic, Plivo Zentrunk, Telnyx, Vonage, and more                 |

### Monitor and improve

| Skill                | Description                                                                           |
| -------------------- | ------------------------------------------------------------------------------------- |
| `get-executions`     | Pull transcripts, recordings, costs, hangup codes, and raw logs from any call         |
| `setup-webhook`      | Stream call updates to your backend in real time                                      |
| `create-disposition` | Extract structured data from transcripts — lead quality, sentiment, appointment times |
| `manage-violations`  | List compliance flags and submit evidence for review                                  |
| `debug-bolna-calls`  | Symptom-to-fix runbook for slow responses, interruptions, SIP issues, and more        |

### Advanced

| Skill                  | Description                                                                                    |
| ---------------------- | ---------------------------------------------------------------------------------------------- |
| `bolna-graph-agents`   | Build deterministic, node-based call flows with LLM, expression, and event-driven transitions  |
| `setup-tools`          | Give agents function-calling tools — live transfer, Cal.com booking, HTTP APIs, and DTMF input |
| `create-knowledgebase` | Add RAG over PDFs or URLs with multilingual document support                                   |
| `manage-subaccounts`   | Multi-tenant workspaces for agencies and enterprise teams                                      |

***

## Supported AI Assistants

Bolna Skills work with any tool that supports the [Agent Skills](https://agentskills.io) format, including:

* [Claude Code](https://claude.ai/code)
* [Cursor](https://cursor.com)
* [OpenAI Codex](https://openai.com/codex)
* [Gemini CLI](https://geminicli.com)
* [Amp](https://ampcode.com)
* [Goose](https://block.github.io/goose)
* And [many more](https://agentskills.io/clients)

***

## Resources

<CardGroup cols={2}>
  <Card title="Skills Repository" icon="github" href="https://github.com/bolna-ai/skills">
    Browse source code, report issues, and contribute
  </Card>

  <Card title="Agent Skills Format" icon="book" href="https://agentskills.io">
    Learn about the Agent Skills standard
  </Card>

  <Card title="API Reference" icon="terminal" href="/api-reference/introduction">
    Full Bolna REST API documentation
  </Card>

  <Card title="Bolna Dashboard" icon="gauge" href="https://platform.bolna.ai">
    Manage agents, API keys, and billing
  </Card>
</CardGroup>