---
title: "Agent skill"
url: "https://raconte.ai/en/docs/skill"
---

### Documentation

[Introduction](/en/docs)[Getting started](/en/docs/getting-started)[MCP server](/en/docs/mcp)[Webhooks](/en/docs/webhooks)[REST API](/en/docs/api)[CLI](/en/docs/cli)[SDK](/en/docs/sdk)[Agent skill](/en/docs/skill)

### Guides

[Configure the MCP server](/en/guides/mcp-setup)[Using the MCP server](/en/guides/mcp-usage)

[Raconte](/) ⟩ [Documentation](/en/docs)

# Agent skill

A ready-made skill that teaches an AI agent to drive Raconte with the CLI.

Raconte publishes an agent-facing **skill** at [raconte.ai/skill.md](/skill.md): a single Markdown file that teaches an AI agent how to install, authenticate and use the [CLI](/en/docs/cli) to run interviews and manage invitations. It is the exact `SKILL.md` shipped inside the `@raconte/cli` package, served verbatim, so it never drifts from the tool.

## What it contains

*   Install (`npm i -g @raconte/cli` or `npx`).
*   Authentication with an organization API key (`RACONTE_API_KEY`).
*   The full command reference (interviews, invitations, voices), with the JSON output and exit-code conventions.
*   Copy-pastable examples.

## Install in your agent

The skill is a standard Markdown file with YAML frontmatter (`name`, `description`), so any agent that loads file-based skills can use it. In every case, also expose your key so the agent can authenticate:

```
export RACONTE_API_KEY="YOUR_API_KEY"
```

### Claude Code

Drop the skill into the project (or `~/.claude/skills/` for all projects):

```
mkdir -p .claude/skills/raconte
curl -fsSL https://raconte.ai/skill.md -o .claude/skills/raconte/SKILL.md
```

Claude Code discovers it automatically; ask it to “send an interview with Raconte” and it will use the CLI.

### OpenClaw

A skill is a folder with a `SKILL.md` inside, just like Claude Code (the two are compatible). Drop it into `~/.openclaw/skills/`:

```
mkdir -p ~/.openclaw/skills/raconte
curl -fsSL https://raconte.ai/skill.md -o ~/.openclaw/skills/raconte/SKILL.md
```

Then restart the gateway, skills are snapshotted at startup.

### Hermes

Hermes installs a single-file skill straight from a URL:

```
hermes skills install https://raconte.ai/skill.md --name raconte
```

In a chat session, use `/skills install https://raconte.ai/skill.md --name raconte --now` to apply it immediately; otherwise it takes effect in new sessions.

For any other assistant, just point it at `https://raconte.ai/skill.md` (or fetch it with `curl`) and set `RACONTE_API_KEY`.

## What the agent can do with it

Create interviews from a prompt, invite participants by email or SMS (or generate a shareable link), send and track invitations, browse voices, and read transcripts and per-message insights, all from one command with JSON output.

See the [CLI reference](/en/docs/cli) for the commands the skill documents, and the [SDK](/en/docs/sdk) for programmatic use from TypeScript.

Table of contents

[1\. What it contains](#what-it-contains)[2\. Install in your agent](#install-in-your-agent)[3\. What the agent can do with it](#what-the-agent-can-do-with-it)