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.
wajub skills install --scope projectwajub login propose cette installation lors de la première exécution. Il est donc possible que vous disposiez déjà de ces skills. L'option --no-skills de la commande de connexion ignore cette proposition.
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
Chaque scope possède deux destinations : une pour la convention ouverte .agents, l'autre pour Claude Code. Les agents qui lisent l'un de ces dossiers les détectent, notamment Codex, Claude Code, Cursor, GitHub Copilot et Gemini CLI.
| Scope | Destinations |
|---|---|
project | ./.agents/skills, ./.claude/skills |
user | ~/.agents/skills, ~/.claude/skills |
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.
$ 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 skills status affiche chaque skill de chaque scope ainsi que son intégrité.
$ wajub skills status
Wajub Agent Skills 1.4.0 (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 |
--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. Il suffit donc de mettre à jour la CLI et de les réinstaller.
npm install -g @wajub/cli
wajub skills install --scope project --forceCommitez 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
wajub skills uninstall --scope project --dry-run
wajub skills uninstall --scope project --yesSans --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.
Pages associées