Skill Palabre

Palabre fournit un skill prêt à l'emploi. Il apprend à un agent IA que Palabre est disponible, quand l'utiliser et comment choisir le bon parcours :

Le skill suit le standard ouvert agentskills.io : il est donc portable entre Claude Code, Codex, Hermes Agent et tout agent compatible skills.

Le skill ne remplace pas la CLI : il pilote palabre en local. Palabre CLI reste la source de vérité pour les agents, les presets, les conversations et les exports.

Installer le skill

Le skill est un dossier : skills/palabre dans le dépôt, et skills/palabre dans le paquet npm installé. Copiez ce dossier entier, références comprises, à l'emplacement attendu par votre agent.

Pour Codex, ~/.agents/skills/ est l'emplacement utilisateur indiqué par la documentation de Codex. L'ancien emplacement ~/.codex/skills/ reste lu par Codex 0.151.0.

Pour Claude desktop ou un autre agent, suivez sa procédure d'installation de skills en pointant vers ce dossier.

Pour installer le skill correspondant à votre CLI, sans téléchargement GitHub :

palabre skill --install codex
palabre skill --install claude

Exécutez seulement la commande correspondant à l'agent voulu. Le plan affiche la cible et demande confirmation. Pour les copies déjà installées, palabre skill --sync utilise le skill du paquet exécuté, sans réseau. palabre skill affiche seulement l'état ; --check et --dry-run n'écrivent rien, même avec --sync ou --install. --yes vaut accord explicite après lecture du plan ; un agent ne l'ajoute pas sans votre accord.

palabre doctor compare tous les fichiers livrés avec chaque copie détectée, en normalisant les fins de ligne. Une différence peut signaler un ancien skill ou une personnalisation. Les ajouts privés sont conservés et ne servent pas à dater le skill. Une copie illisible ou comportant un lien interne reste non vérifiée et son remplacement est refusé.

palabre update inclut le rafraîchissement des copies détectées dans son plan et sa confirmation unique. Après mise à jour, il utilise le skill du nouveau paquet, y compris avec un store pnpm différent. Si la CLI est déjà à jour, le rafraîchissement d'un skill différent reste proposé. Une copie absente n'est jamais installée implicitement.

Avant remplacement, chaque copie physique est sauvegardée sous ~/.palabre/skill-backups/, avec date et suffixe unique, hors des dossiers chargés par les agents. Les jonctions racines restent en place ; un même dossier visé par Claude et Codex n'est sauvegardé qu'une fois. Les fichiers personnalisés livrés sont remplacés après cet accord ; les fichiers supplémentaires sont conservés. Une édition depuis l'affichage du plan fait refuser le rafraîchissement. Rechargez ensuite le skill ou reprenez la conversation de l'agent.

Ces commandes suivent le paquet de la CLI, pas GitHub main. Un outil externe comme npx skills add/update suit le dépôt et peut donc fournir un skill différent de la version CLI installée. Sur une ancienne CLI sans commande skill, la copie manuelle du dossier embarqué reste possible.

Pour commencer, dites à Claude Code ou à Codex : « Passe par PALABRE pour demander à l’autre agent de relire le plan dans docs/plan.md, sans modifier de fichier. Garde la conversation pour la suite. » Vous choisissez le chef de mission. Depuis Codex desktop, chaque commande vers Claude demande une autorisation ponctuelle de l’hôte ; suivez Premier Relay.

Une copie non vérifiable est affichée avec un avertissement et laissée intacte : elle ne bloque ni la mise à jour CLI ni les autres copies du skill. Si aucune copie n'est différente, --sync et --install ne demandent pas d'accord et n'écrivent rien. Si la CLI est mise à jour mais que le rafraîchissement du skill échoue ensuite, le message distingue les deux résultats : relancez Palabre, puis palabre skill --sync pour examiner le nouveau plan.

Quand l'agent voit le skill

Un agent charge la liste des skills quand une conversation démarre ou reprend. Après l'installation, ouvrez une nouvelle conversation ou reprenez-en une : une conversation déjà en cours ne voit pas forcément le skill.

Ces comportements ont été vérifiés en mode non interactif (claude -p, codex exec), avec un skill de projet et des conversations jetables. Les emplacements utilisateur, la TUI, les applications de bureau et les IDE n'ont pas été vérifiés. Ces comportements peuvent changer avec d'autres versions. Si l'agent ne mentionne pas Palabre, rappelez-lui que le skill palabre est disponible.

Une seule copie du skill doit rester active. Si une ancienne version est aussi installée, par exemple un skill palabre ajouté à votre compte Claude puis synchronisé, l'agent peut suivre l'ancienne : mettez-la à jour ou retirez-la.

Prérequis

• Palabre CLI installé sur la même machine (npm install --global palabre) ;
• au moins un agent compatible configuré ou détecté par Palabre ; deux ou plus sont recommandés pour les comparaisons ;
• un agent hôte compatible avec le standard agentskills.io.

Vérifiez l'installation depuis un terminal :

palabre --version
palabre doctor
palabre agents

Ce que le skill apporte

Le point d'entrée présente les décisions et garde-fous communs ; l'agent charge ensuite la référence du parcours utile. Relay distingue les bases, l'ouverture/suivi Desktop, le pilote OpenCode et les fonctions gelées. Les détails des autres parcours ne sont pas chargés par défaut.

Pour poursuivre un avis Codex/Claude sans modification, les recettes gardent --background, même si vous avez ouvert la conversation entre-temps : une cible occupée est refusée, sans basculement silencieux vers ses permissions. Ouvrir pour consulter et envoyer restent deux actions distinctes ; l'ouverture Codex conserve la configuration effective absolue.

Ici, un agent Palabre est une entrée configurée reliée à un outil IA (par exemple Claude Code ou Codex) ou à Ollama, pas un modèle ni un sous-agent. Les rôles complètent Débat, Ask et Chat ; ils ne règlent pas Relay et n'accordent aucun droit.

Nommer les tâches PALABRE

Votre agent nomme chaque tâche PALABRE Palabre <mode> : <objet>, par exemple Palabre Relay : envoyer la relecture à Codex. C'est le skill qui le lui demande ; l'application de votre agent décide de ce qu'elle affiche réellement.

Dans un terminal, PALABRE affiche son nom et son mode dans le titre de la fenêtre, par exemple Palabre · Relay. Il remet l'ancien titre à la fin quand le terminal le permet. Rien n'est ajouté quand PALABRE est lancé par un programme ou avec --json. Sous Windows, le Gestionnaire des tâches continue d'afficher node.

Choisir et suivre le parcours

• Choix du parcours : Débat, Relay, Ask ou Chat selon le besoin, sans lancer Palabre pour une tâche simple ni imposer un Débat à chaque demande de second avis.
• Chat piloté proprement : l'agent utilise le flux NDJSON et les commandes JSON sur stdin (chat-send, chat-consult, chat-use, chat-agents, chat-end), jamais une imitation de la TUI. Il connaît la mémoire bornée de Chat : six messages récents, aucune reprise après arrêt.
• Trois reprises distinguées : la conversation de l'agent hôte, les checkpoints Palabre de Débat et Ask, et la reprise d'une conversation externe par Relay.
• Relay prudent : cible désignée par vous ; en-tête PALABRE, avertissement ℹ️ et « 🤖 Message pour l'agent » ; objet facultatif --subject, expéditeur non authentifié, historique modifié, aucun renvoi automatique ; diagnostic usage-limit conservé, et readAccess distingue un repli partiel d'un blocage sans effacer réponse ni délivrance.
• Contexte maîtrisé : --files ou --context, avec un avertissement avant d'envoyer du contenu sensible ; Ollama pour rester en local.
• Vous gardez la main : installation, authentification, configuration, approbation de config et mises à jour restent vos décisions. Le rôle implementer est une consigne de proposition, pas une autorisation d'écrire.
• Restitution : l'agent lit l'export (.chat.md, .debate.md, .ask.md ou .relay.md, ainsi que .mission.md pour l’option Mission) et vous rend décisions, désaccords, limites et prochaines étapes. Après un Relay, le compte rendu reste simple : ce que l'équipier a fait, ce qui bloque, la décision attendue et, si besoin, une seule action à faire (par exemple la commande pour ouvrir la conversation dans Codex Desktop). L'agent garde lui-même l'identifiant de la conversation : dites « continue » ou « demande au même Codex » pour poursuivre. Il ne vous montre l'identifiant, le dossier, l'export ou la commande palabre relay que si vous les demandez, ou pour expliquer un échec.

L’option Mission et --task review sont gelés. --write est expérimental, gelé et hors parcours par défaut : le skill ne le propose que sur demande explicite de l’humain. Ces fonctions restent documentées ; seuls les correctifs de sécurité sont acceptés.

L'agent ne modifie ni n'approuve lui-même une politique qui lui accorde des droits : il vous montre la commande relay allow-repo ou d'approbation et attend votre action. Pour retrouver le skill du paquet installé : npm root -g (ou pnpm root -g), puis le sous-dossier palabre/skills/palabre.