Skills pour agents

Fournissez à votre agent de développement les règles Wajub qu'il devrait autrement deviner.

Un agent de développement qui écrit une intégration Wajub de mémoire comprend la structure générale, mais se trompe sur les détails : il lit event.type au lieu de event, analyse le corps avant de vérifier la signature ou envoie un montant en unités mineures. Les Skills pour agents ajoutent ces règles à votre dépôt afin que l'agent les lise au lieu de les deviner.

Vous avez rarement quelque chose à lancer : depuis la CLI 1.5.0, la première commande exécutée après l'installation ou la mise à jour de la CLI copie les skills dans les dossiers des agents de développement trouvés sur votre machine, et l'indique. wajub login fait de même. Redémarrez ensuite votre agent : Claude Code, Codex et les autres lisent leurs skills au démarrage d'une session, jamais pendant.

Les commiter avec un projet, pour toute l'équipe

wajub skills install --scope project

CLI 1.4.0 et antérieures

npm install -g @wajub/cli seul n'installe rien pour vos agents : les skills restent dans le package npm, où aucun agent ne regarde, jusqu'à l'exécution de wajub login. Mettez la CLI à jour, ou lancez une fois wajub skills install --scope user.

Contenu de l'installation

Dix skills sont installés. Chacun contient un fichier SKILL.md accompagné d'un document de référence. Un agent charge celui dont la description correspond à la tâche en cours et ignore les autres.

Skill	Domaine couvert
`wajub-integrate`	De bout en bout : détecter la stack, choisir le SDK et le mode de checkout, coordonner les différents éléments
`wajub-payments`	Checkout, remboursements, Checkout hébergé, liens de paiement, Composants intégrés, feuilles mobiles
`wajub-webhooks`	Signatures, corps bruts, nouvelles tentatives, idempotence, transfert local
`wajub-payouts`	Transferts, bénéficiaires, suivi du statut des payouts
`wajub-billing`	Création, livraison et mise à jour des factures, marquage comme payées et annulation
`wajub-platform-api`	Comptes, clients, solde, litiges, événements, requêtes authentifiées brutes
`wajub-shield`	Contrôles antifraude, listes de blocage, paramètres de risque, décisions
`wajub-tax`	Intégrations fiscales et processus liés aux taxes
`wajub-sync`	Synchronisation Sync, rapprochement, cohérence pilotée par les événements
`wajub-testing`	Scénarios de sandbox, CLI, transfert de webhooks, vérifications avant le passage en live

La suite est liée à une version de l'API, actuellement 2026-08-01. Les conseils et la plateforme ne peuvent donc pas diverger silencieusement.

Emplacement de l'installation

Deux dossiers par scope : .agents/skills, la convention ouverte que lisent la plupart des agents, et .claude/skills, le seul que lit Claude Code.

Scope	Destinations
`project`	`./.agents/skills`, `./.claude/skills`, à la racine du dépôt git
`user`	`~/.agents/skills`, `~/.claude/skills` (`$CLAUDE_CONFIG_DIR/skills` si cette variable est définie)

Chaque agent lit sa propre sélection. Voici ce que chacun a chargé lorsque nous avons listé ses skills, vérifié avec leurs dernières versions.

Agent	Projet	Utilisateur	Depuis un sous-dossier
Claude Code	`.claude/skills`	`~/.claude/skills`, ou `$CLAUDE_CONFIG_DIR/skills`	Oui
Codex	`.agents/skills`	`~/.agents/skills`	Oui
GitHub Copilot CLI	`.agents/skills`, `.claude/skills`	`~/.agents/skills`	Oui
Gemini CLI	`.agents/skills`, dans un dossier approuvé	`~/.agents/skills`	Non
OpenCode	les deux	les deux	Oui
Cursor	les deux	les deux	Non vérifié
Windsurf	`.agents/skills`, `.claude/skills`	`~/.agents/skills`	Non vérifié

Les deux scopes écrivent les deux dossiers : aucun n'atteint à lui seul Claude Code et Codex, et un agent installé la semaine prochaine, ou celui d'un membre de l'équipe, doit aussi les trouver. Cursor et OpenCode lisent les deux ; OpenCode garde un seul exemplaire de chaque skill et signale le nom en double dans ses logs. --target agents ou --target claude n'en écrit qu'un.

Le scope du projet est commité avec votre dépôt. Toute l'équipe et chaque exécution d'agent disposent ainsi des mêmes règles. Le scope utilisateur vous suit d'un dépôt à l'autre. Vous pouvez installer les deux. La copie du projet prévaut lorsqu'un agent lit les deux.

Prévisualiser les changements avant leur application

$ wajub skills install --scope project --dry-run

Planned destinations (project):
  agents: /Users/you/code/shop/.agents/skills
  claude: /Users/you/code/shop/.claude/skills
  ✓ install  wajub-integrate (agents)
  ✓ install  wajub-payments (agents)
  ✓ install  wajub-webhooks (agents)
  …

Vérifier les skills installés

wajub doctor répond à la question qui compte, agent par agent : voit-il les skills, et sinon, quelle commande lancer. wajub skills status affiche chaque skill de chaque scope ainsi que son intégrité.

wajub skills status

$ wajub skills status

Wajub Agent Skills 1.7.3 (API 2026-08-01)
  current   wajub-integrate      project/agents
  current   wajub-payments       project/agents
  modified  wajub-webhooks       project/agents
  absent    wajub-shield         project/agents
  …

modified signifie que le dossier ne correspond plus à ce que la CLI a installé, généralement parce qu'une personne a modifié un skill à la main. Une installation ordinaire ne touche pas à ces dossiers afin de ne pas écraser vos changements. --force les remplace.

Option	Commande	Effet
`--scope`	les trois	`project` ou `user`. `status` accepte aussi `all`
`--target`	`install`	`all` (par défaut), `agents` ou `claude` : les dossiers à écrire
`--dry-run`	`install`, `uninstall`	Affiche le plan sans rien écrire
`--force`	`install`	Remplace les dossiers existants ou modifiés localement
`--force`	`uninstall`	Supprime également les dossiers non gérés
`-y`, `--yes`	`uninstall`	Ignore la demande de confirmation
`--json`	les trois	Produit une sortie exploitable par une machine

Maintenir les skills à jour

Les skills sont fournis dans le package de la CLI. Le scope utilisateur se met à jour de lui-même à la première commande qui suit chaque mise à jour de la CLI, sans toucher aux skills que vous avez modifiés. Le scope d'un projet fait partie de votre dépôt : il ne change que lorsque vous le demandez.

Mettre à jour un projet

npm install -g @wajub/cli
wajub skills install --scope project

Rien n'est installé automatiquement en CI (lorsque CI est définie), pour une commande lancée avec --json, dans le dossier personnel d'un autre utilisateur (sudo conserve HOME sur macOS), ni après un refus de votre part. Une installation qui échoue est signalée une fois et retentée à la commande suivante. Une CLI plus ancienne, comme la devDependency d'un projet à côté d'une installation globale plus récente, ne remet jamais ses anciens skills.

Commitez le scope du projet

.agents/skills et .claude/skills contiennent du texte. Si vous les commitez, un membre de l'équipe qui clone le dépôt reçoit les mêmes conseils sans rien exécuter. Une revue de code montre aussi précisément les changements apportés lors d'une mise à jour.

Supprimer les skills

Désinstaller

wajub skills uninstall --scope project --dry-run
wajub skills uninstall --scope project --yes

Sans --force, les dossiers que vous avez modifiés restent en place, car vos changements sont supposés avoir plus de valeur qu'une suppression complète.

Supprimer le scope utilisateur désactive aussi l'installation automatique, pour que la commande suivante ne les remette pas ; wajub skills install --scope user la réactive. WAJUB_NO_SKILLS=1 et wajub login --no-skills la désactivent sans rien supprimer.

Quand un agent ne les voit pas

Lancez wajub doctor : il nomme chaque agent qui ne voit pas les skills et la commande qui corrige le problème. Les causes habituelles, dans l'ordre :

L'agent tournait déjà. Les skills sont lus au démarrage d'une session. Redémarrez-le.
Les skills n'ont jamais été copiés. Jusqu'à la CLI 1.4.0, seul wajub login les installait. Lancez wajub skills install --scope user.
Gemini CLI et une installation de projet. Il ne lit les skills d'un projet que dans un dossier approuvé, et seulement dans le dossier où il démarre, pas depuis un sous-dossier du dépôt. Approuvez le dossier quand il le demande et démarrez-le à la racine, ou comptez sur le scope utilisateur.
CLAUDE_CONFIG_DIR est définie. Claude Code lit alors $CLAUDE_CONFIG_DIR/skills au lieu de ~/.claude/skills. Lancez wajub skills install --scope user depuis un shell où elle est définie.
Le skill existe mais l'agent ne s'en sert pas. Un agent charge un skill quand sa description correspond à la demande. Formulez la tâche simplement : « vérifie la signature du webhook » plutôt que « corrige l'endpoint ».

Pages associées