Bibliothèque de skills

Un skill décrit une méthode de travail réutilisable : rédiger des notes de version, vérifier un brief ou préparer un document selon les conventions de ton équipe. Il contient un fichier d’instructions SKILL.md et, si nécessaire, des fichiers complémentaires. Entretiens-le dans Paramètres > Skills, puis équipe les agents concernés.

Un skill agit partout où le travail se fait. Dans le chat, l’assistant peut utiliser chaque skill de ta bibliothèque : il en lit un quand il correspond à ta demande, ou quand tu le nommes. Un agent de projet qui traite une tâche, ou un nœud agent dans une automatisation, utilise les skills dont il est équipé. Toute personne qui peut ouvrir le projet peut créer une tâche ; équiper un agent d’un skill demande au moins le rôle Éditeur.

Chaque membre peut créer un skill et modifier les siens. Pour modifier ou supprimer le skill partagé d’une autre personne, il faut être administrateur de l’organisation. Ton organisation peut réserver le partage avec tout le monde à certains rôles ; voir Qui peut partager avec tout le monde.

Créer un petit skill

1. 1

   Nommer le skill et préciser quand l’utiliser

   Ouvre Paramètres > Skills, puis Ajouter un skill > Skill vierge. Saisis un Nom, par exemple brief-summary, et une Description :

   text

   Résume un brief de projet en indiquant la date de relecture, le responsable
   et les questions ouvertes. À utiliser pour une passation ou une vérification rapide.

   Le nom est un identifiant unique : lettres minuscules, chiffres et tirets simples, jusqu’à 64 caractères. La description indique au modèle dans quels cas lire le skill. Sous Visibilité, choisis qui voit le skill : Organisation, ou Équipes avec au moins une équipe. Clique sur Créer pour l’ajouter et ouvrir son éditeur.

2. 2

   Rédiger les instructions

   Sous Instructions (corps), donne une procédure courte et un résultat vérifiable. Par exemple :

   markdown

   Lis le brief fourni. Produis un tableau de trois lignes : date de relecture,
   responsable et questions ouvertes. Cite la phrase qui justifie chaque réponse.
   Écris « Non précisé » si l’information manque. Ne déduis pas une date de
   lancement d’une date de relecture.

   Ajoute des fichiers de référence lorsqu’ils aident à suivre la procédure. Place les exemples détaillés dans ces fichiers et précise quand l’agent doit les ouvrir.

3. 3

   Choisir le public et enregistrer

   À la création, Organisation est présélectionnée, sauf si ton organisation la réserve. Si le contenu s’adresse à un autre public, change-le sous Visibilité : Équipes demande au moins une équipe. Ajoute une icône ou des libellés si cela facilite la recherche, puis clique sur Enregistrer.

   Créer un skill ne l’ajoute pas automatiquement à un agent. Ouvre l’agent du projet concerné et sélectionne le skill dans son équipement. Lance une petite tâche avec des données connues, puis compare le résultat aux instructions.

Importer un bundle existant

Utilise Ajouter un skill > Téléverser un zip ou Téléverser un dossier. Le bundle doit contenir SKILL.md à sa racine. Des références, ressources et scripts peuvent l’accompagner :

brief-summary/
├── SKILL.md
└── references/
    └── example-brief.md

L’aperçu présente les métadonnées, le partage, la licence et la liste des fichiers avant que Téléverser le bundle n’enregistre quoi que ce soit. Vérifie le contenu et le public. Sans visibility, le partage est ouvert à l’organisation. Si ton organisation le réserve et que tu ne peux pas publier, l’aperçu le signale et Téléverser le bundle reste indisponible ; ajoute visibility: team et les identifiants de tes équipes dans SKILL.md. Quand tu crées un skill d’équipe ou modifies ses équipes, tu ne peux indiquer que des équipes de ton organisation, et seulement les tiennes si tu n’es pas administrateur. Tu peux conserver la liste existante même si une équipe a été supprimée depuis. Un owner indiqué dans le fichier est ignoré : un nouveau skill t’appartient. Un skill remplacé garde son propriétaire actuel ou t’appartient s’il n’en avait pas. Si le nom existe déjà, Tale demande s’il faut remplacer le skill ; ce remplacement concerne aussi les agents qui l’utilisent.

Comprendre le partage

L’accès du projet détermine son équipement, même si tu peux personnellement lire davantage de skills. Un projet ouvert à l’organisation peut utiliser les skills de l’organisation. Les anciens skills privés restent visibles par leur propriétaire, mais aucun agent ne peut les équiper. Les nouveaux skills privés ne sont pas acceptés.

Restreindre la visibilité demande une confirmation, car certains agents peuvent perdre l’accès. La suppression a la même conséquence pratique : une exécution qui dépend du bundle manquant ne peut plus le préparer. Vérifie les usages d’un skill partagé avant de le restreindre ou de le retirer.

Qui peut partager avec tout le monde

Par défaut, chaque membre peut partager un skill avec toute l’organisation. Un admin peut réserver ce droit aux éditeurs et au-delà, ou aux propriétaires et aux admins, dans Partage des skills, et autoriser certains membres à publier avec la compétence Publier des skills pour l'organisation. Quand ton organisation le réserve et que tu ne peux pas publier :

• Organisation n’est pas disponible sous Visibilité, et un nouveau skill commence avec Équipes. Tu peux partager avec tes propres équipes.
• Un skill partagé avec l’organisation que tu as créé ne peut pas être modifié sur place. Restreins-le à tes équipes, avec d’autres modifications dans le même enregistrement si besoin, ou supprime-le.
• L’aperçu du téléversement signale un bundle qui serait partagé avec toute l’organisation, y compris un bundle sans visibility, et Téléverser le bundle reste indisponible.

Les skills déjà partagés avec l’organisation le restent.

Voir qui a créé et modifié un skill

La colonne Créé par indique le membre qui a créé chaque skill. Recherche un nom dans la bibliothèque pour retrouver tout ce que cette personne a partagé. Pour un skill sans créateur enregistré, comme les skills de documents fournis à la création de ton organisation, elle affiche Fourni avec Tale ; pour un skill installé par une release de configuration gérée, Release de configuration suivi du membre dont le téléversement l’a installé. Quand le créateur a quitté l’organisation, elle affiche Ancien membre.

Ouvre un skill pour voir Créé par et Dernière modification par : le membre dont l’enregistrement ou le téléversement dans Tale a produit la version actuelle. Dernière modification par n’apparaît pas si personne n’a modifié le skill depuis sa création, ou si son fichier a changé en dehors de Tale depuis la dernière modification. La liste des skills dans l’équipement d’un agent indique elle aussi le créateur sous chaque skill.

Tale consigne dans le journal d’audit la création, la modification, le téléversement et la suppression d’un skill, ainsi que chaque changement de sa visibilité ou de ses équipes. Les administrateurs et propriétaires trouvent ces entrées dans Paramètres > Gouvernance > Journaux, catégorie Skill.

Référence du fichier

Voici un SKILL.md minimal :

---
name: brief-summary
description: Résume un brief de projet. À utiliser pour les passations et vérifications.
visibility: org
---

Lis le brief. Indique la date de relecture, le responsable et les questions
ouvertes. Cite les preuves et marque les informations absentes « Non précisé ».

Tale conserve les clés de frontmatter inconnues. Le frontmatter est limité à 16 KB et le fichier SKILL.md complet à 512 KB. Les instructions lues souvent doivent rester bien plus courtes.

Actualiser et résoudre les problèmes

Ouvre une ligne pour modifier la description, les instructions, les libellés et la visibilité. L’arborescence Bundle permet d’examiner les fichiers complémentaires. Les agents ne sont pas liés à une version précise : la prochaine préparation utilise le bundle courant. Teste donc les changements partagés sur une tâche représentative.

Le champ Libellés accepte jusqu’à huit libellés séparés par des virgules, de 40 caractères au plus chacun. Si la liste est plus longue ou qu’un libellé est trop long, le champ indique ce qu’il faut retirer ou raccourcir, et Enregistrer reste indisponible. Rien de ce que tu as saisi n’est perdu. L’arborescence Bundle retient, pour chaque skill et dans ton navigateur, les dossiers que tu as repliés.

Si Tale ne parvient pas à charger un skill ou l’un de ses fichiers, la boîte de dialogue l’indique et propose Réessayer. Si une actualisation échoue, la version déjà affichée reste en place, modifications non enregistrées comprises. Un fichier retiré est signalé comme absent du bundle, et un fichier vide comme vide.

Si quelqu’un d’autre enregistre le skill après que tu l’as ouvert, Tale refuse ton enregistrement et te le signale. Rien n’est écrasé et tes modifications restent dans l’éditeur : copie ce dont tu as besoin, puis ferme le skill et rouvre-le pour voir la dernière version. Un éditeur que tu n’as pas modifié reprend tout seul la version plus récente.

Si un agent ne trouve pas le skill, vérifie son équipement et la visibilité pour le projet. Tale lui montre un extrait de la description, limité à 300 caractères, pour l’aider à choisir un skill pertinent. Indique donc d’abord quand le skill s’applique. S’il ignore un skill équipé, nomme-le dans la tâche et compare le résultat avec ses instructions. Skills des agents explique comment le bundle équipé est préparé et présenté à l’agent.

En cas d’erreur d’import, vérifie que SKILL.md est à la racine, que son frontmatter est valide et que son nom est accepté. L’erreur précise les chemins ou limites de taille en cause. Pour retirer un bundle, ouvre-le et choisis Supprimer le skill après avoir vérifié les agents concernés.