Rolebase

Skill Rolebase

Laissez Claude Code, Codex, Cursor ou VS Code piloter votre compte Rolebase via l'API avec la skill Rolebase.

Télécharger la skill Rolebase

Vue d'ensemble

La skill Rolebase apprend à un agent de développement à piloter tout votre compte Rolebase via l'API HTTP (GraphQL et tRPC), avec curl et une clé API lue dans l'environnement. Elle fonctionne dans tout agent qui dispose d'un terminal et prend en charge le standard ouvert Agent Skills : Claude Code, Codex, Cursor, VS Code avec GitHub Copilot et d'autres.

Skill ou serveur MCP

La skill est une alternative au serveur MCP. Les deux donnent à l'agent le même guide : règles de conduite (accord avant toute écriture, bonne organisation, vocabulaire de l'application), modèle de données et requêtes prêtes à l'emploi.

  • Choisissez le serveur MCP pour les assistants sans terminal, comme Claude, ChatGPT ou Mistral Vibe, ou si vous préférez un connecteur géré par votre outil.
  • Choisissez la skill quand l'agent travaille dans un terminal : rien à configurer au-delà d'une variable d'environnement, et l'agent peut scripter ses appels.

Pour connecter un assistant conversationnel pas à pas, consultez le guide Utiliser Rolebase avec un assistant IA.

Définir la clé API

Créez une clé depuis Mon compte > Clés API dans Rolebase, puis définissez-la dans l'environnement depuis lequel l'agent démarre, par exemple dans le profil de votre shell :

Terminal window
export ROLEBASE_API_KEY=<votre-cle-api>
# Facultatif, pour une instance auto-hébergée ou locale
export ROLEBASE_API_URL=http://localhost:8888

La skill ne demande jamais la clé dans la conversation et ne l'affiche jamais.

Installer la skill

Claude Code

Installez le plugin Rolebase, qui contient la skill :

/plugin marketplace add Godefroy/rolebase
/plugin install rolebase@rolebase

Codex, Cursor et VS Code

Ces outils chargent tous les skills depuis ~/.agents/skills/. Décompressez-y le fichier téléchargé, ou récupérez la skill directement depuis un terminal :

Terminal window
mkdir -p ~/.agents/skills/rolebase && cd ~/.agents/skills/rolebase
curl -fsSLO https://raw.githubusercontent.com/Godefroy/rolebase/main/plugins/rolebase/skills/rolebase/SKILL.md
curl -fsSLO https://raw.githubusercontent.com/Godefroy/rolebase/main/plugins/rolebase/skills/rolebase/reference.md

Pour la partager avec l'équipe d'un projet, placez plutôt le même dossier dans .agents/skills/rolebase/ à la racine du dépôt.

Mises à jour

La skill se trouve dans plugins/rolebase/skills/rolebase et suit l'évolution du produit. Pour la mettre à jour, lancez /plugin marketplace update rolebase dans Claude Code, ou téléchargez de nouveau la skill.

Quand l'API contredit la skill, l'agent consulte la documentation en ligne, poursuit avec le comportement à jour et vous signale ce qui était dépassé.