---
title: "Agent skill | Raconte"
description: "A ready-made skill that teaches an AI agent to drive Raconte with the CLI."
url: "https://raconte.ai/en/docs/skill"
---

# 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:

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

### Claude Code

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

```bash
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/`:

```bash
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:

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