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 : un seul fichier Markdown qui apprend à un agent IA comment installer, s’authentifier et utiliser le 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 pour les commandes documentées par la skill, et le SDK pour un usage programmatique en TypeScript.