---
title: "Skill agent"
url: "https://raconte.ai/fr/docs/skill"
---

### Documentation

[Introduction](/fr/docs)[Démarrer](/fr/docs/getting-started)[Serveur MCP](/fr/docs/mcp)[Webhooks](/fr/docs/webhooks)[API REST](/fr/docs/api)[CLI](/fr/docs/cli)[SDK](/fr/docs/sdk)[Skill agent](/fr/docs/skill)

### Guides

[Configurer le serveur MCP](/fr/guides/mcp-setup)[Utiliser le serveur MCP](/fr/guides/mcp-usage)

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

# Skill agent

Une skill prête à l'emploi qui apprend à un agent IA à piloter Raconte avec le CLI.

Raconte publie une **skill** pour agents IA sur [raconte.ai/skill.md](/skill.md) : un seul fichier Markdown qui apprend à un agent IA comment installer, s’authentifier et utiliser le [CLI](/fr/docs/cli) pour lancer des interviews et gérer les invitations. C’est exactement le `SKILL.md` livré dans le package `@raconte/cli`, servi tel quel : il ne dérive donc jamais de l’outil.

## Ce qu’elle contient

*   L’installation (`npm i -g @raconte/cli` ou `npx`).
*   L’authentification avec une clé d’API d’organisation (`RACONTE_API_KEY`).
*   La référence complète des commandes (interviews, invitations, voices), avec les conventions de sortie JSON et de codes de sortie.
*   Des exemples copiables.

## Installer dans votre agent

La skill est un fichier Markdown standard avec frontmatter YAML (`name`, `description`) : n’importe quel agent qui charge des skills depuis un fichier peut l’utiliser. Dans tous les cas, exposez aussi votre clé pour que l’agent s’authentifie :

```
export RACONTE_API_KEY="VOTRE_CLE_API"
```

### Claude Code

Placez la skill dans le projet (ou `~/.claude/skills/` pour tous les projets) :

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

Claude Code la détecte automatiquement ; demandez-lui d’« envoyer une interview avec Raconte » et il utilisera le CLI.

### OpenClaw

Une skill est un dossier contenant un `SKILL.md`, comme pour Claude Code (les deux sont compatibles). Placez-la dans `~/.openclaw/skills/` :

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

Puis redémarrez le gateway : les skills sont capturées au démarrage.

### Hermes

Hermes installe une skill mono-fichier directement depuis une URL :

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

Dans une session de chat, utilisez `/skills install https://raconte.ai/skill.md --name raconte --now` pour l’activer immédiatement ; sinon elle prend effet dans les nouvelles sessions.

Pour tout autre assistant, pointez-le simplement sur `https://raconte.ai/skill.md` (ou récupérez-le avec `curl`) et définissez `RACONTE_API_KEY`.

## Ce que l’agent peut faire

Créer des interviews à partir d’un prompt, inviter des participants par email ou SMS (ou générer un lien partageable), envoyer et suivre des invitations, parcourir les voix, et lire les transcripts et analyses par message, le tout en une commande avec sortie JSON.

Voir la [référence CLI](/fr/docs/cli) pour les commandes documentées par la skill, et le [SDK](/fr/docs/sdk) pour un usage programmatique en TypeScript.

Sommaire

[1\. Ce qu’elle contient](#ce-quelle-contient)[2\. Installer dans votre agent](#installer-dans-votre-agent)[3\. Ce que l’agent peut faire](#ce-que-lagent-peut-faire)