Skip to main content

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 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.

Build Agents

Create and configure voice agents with prompts, voices, and tools

Make Calls

Place outbound calls, run batch campaigns, and set up inbound numbers

Monitor & Debug

Pull transcripts, set up webhooks, extract data, and troubleshoot calls

Installation

Install Bolna Skills in your project with a single command:
npx skills add bolna-ai/skills
To install for a specific AI assistant:
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:
npx skills add bolna-ai/skills --skill create-agent

Setup

Get your API key from the Bolna Dashboard → Developers and export it:
export BOLNA_API_KEY="your-api-key"
You can also add it to a .env file in your project:
BOLNA_API_KEY=your-api-key
Make sure .env is listed in your .gitignore to avoid committing secrets.

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

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.
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.
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.
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.
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.
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.

Available Skills

Build agents

SkillDescription
setup-api-keyGenerate, store, and verify your BOLNA_API_KEY
add-providerBring your own OpenAI, Anthropic, Azure, ElevenLabs, Deepgram, Twilio, Plivo, and other provider credentials
create-agentCreate a voice agent end-to-end — LLM, voice, transcriber, telephony, knowledge bases, and function tools
manage-agentsList, update, delete, or stop queued calls for an agent
prompt-writingAuthor production voice prompts with sectioned structure, multilingual entries, and FAQ in YAML

Make calls

SkillDescription
make-callPlace a single outbound call — immediate or scheduled, with dynamic variables and auto-retry
create-batchRun CSV-driven outbound campaigns at scale with scheduling and monitoring
setup-inboundWire phone numbers to agents with IVR menus, caller identification, and multilingual auto-switching
manage-phone-numbersSearch and buy US or India phone numbers
setup-sip-trunkBring your own SIP trunk — Twilio Elastic, Plivo Zentrunk, Telnyx, Vonage, and more

Monitor and improve

SkillDescription
get-executionsPull transcripts, recordings, costs, hangup codes, and raw logs from any call
setup-webhookStream call updates to your backend in real time
create-dispositionExtract structured data from transcripts — lead quality, sentiment, appointment times
manage-violationsList compliance flags and submit evidence for review
debug-bolna-callsSymptom-to-fix runbook for slow responses, interruptions, SIP issues, and more

Advanced

SkillDescription
bolna-graph-agentsBuild deterministic, node-based call flows with LLM, expression, and event-driven transitions
setup-toolsGive agents function-calling tools — live transfer, Cal.com booking, HTTP APIs, and DTMF input
create-knowledgebaseAdd RAG over PDFs or URLs with multilingual document support
manage-subaccountsMulti-tenant workspaces for agencies and enterprise teams

Supported AI Assistants

Bolna Skills work with any tool that supports the Agent Skills format, including:

Resources

Skills Repository

Browse source code, report issues, and contribute

Agent Skills Format

Learn about the Agent Skills standard

API Reference

Full Bolna REST API documentation

Bolna Dashboard

Manage agents, API keys, and billing