Raconte Raconte

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: a single Markdown file that teaches an AI agent how to install, authenticate and use the 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 for the commands the skill documents, and the SDK for programmatic use from TypeScript.