Skills

Un skill est un ensemble réutilisable de méthodes de travail au sein d'un espace de travail. Son fichier principal est SKILL.md, éventuellement accompagné de scripts, de modèles et de supports de référence.

Ajoutez un skill à un agent : l'agent suit ses consignes lorsqu'il effectue un travail lié. Il n'est plus nécessaire de copier la même méthode dans les instructions de chaque agent, et les mises à jour se font à un seul endroit.

Skills et instructions de l'agent

Créer ou importer un skill

Sur la page Skills de l'espace de travail, choisissez « Nouveau skill ». Quatre options sont disponibles :

La copie depuis un runtime prend un instantané des fichiers à ce moment-là. Les modifications ultérieures des fichiers locaux ne mettent pas automatiquement à jour la version de l'espace de travail ; réimportez le skill ou modifiez-le dans trackica.

Le même format d'archive fonctionne depuis le CLI :

trackica skill import --file ./review-helper.skill

Si un skill portant le même nom existe déjà dans l'espace de travail, l'import peut s'arrêter, écraser le contenu existant, enregistrer sous un nouveau nom ou ignorer le skill. L'écrasement par import est réservé au créateur du skill ; un admin de l'espace de travail qui peut modifier le skill dans l'application ne peut pas pour autant l'écraser par import. Pour récupérer une version plus récente d'un skill déjà présent dans l'espace de travail, utilisez plutôt Mettre à jour un skill importé.

Discuter d’un skill avant de l’enregistrer

Créer avec un agent ouvre une conversation dédiée avec l’agent et le niveau de réflexion choisis. Précisez vos besoins sur plusieurs échanges, consultez le SKILL.md généré et ses fichiers annexes, puis modifiez le brouillon. Les réponses et la fin des exécutions ne font que mettre à jour le brouillon : seule l’action Confirmer et enregistrer le skill le publie. Elle vérifie la révision exacte de l’aperçu et attend la fin de tous les échanges. Une réponse en échec, annulée, vide ou invalide conserve le dernier brouillon valide. Si le nom existe déjà, le brouillon reste disponible pour être renommé ; une confirmation répétée renvoie le même skill enregistré.

Vous pouvez choisir un projet après avoir démarré la conversation. Sans projet sélectionné, l’agent ne peut pas lire les tâches des projets. Une fois le projet choisi, le serveur autorise uniquement ses tâches auxquelles vous avez actuellement accès et qui ont été modifiées au cours des 30 derniers jours. Les pages de résumés et de commentaires contiennent 20 entrées ; l’analyse couvre au maximum 100 tâches candidates. Les réponses indiquent la pagination et la couverture, et les sources lues sont consignées. Changer de projet ouvre une nouvelle conversation afin de ne pas reprendre le contexte précédent. Les sources déjà lues sont revérifiées avant de continuer ou d’enregistrer.

Les tâches de création utilisent un jeton de plateforme restreint. Il peut lire cette conversation et les tâches du projet autorisées, mais pas rechercher d’autres données de l’espace, lire des dépôts, déléguer du travail ni enregistrer un skill. Les droits plus larges du propriétaire du runtime n’étendent pas votre périmètre. Il s’agit de contrôles d’accès de la plateforme, pas d’un bac à sable pour tout l’hôte du runtime. Un daemon à jour annonçant skill-creation-v1 est requis ; l’ancien endpoint de génération en une seule étape renvoie une erreur de retrait.

L’agent de création peut lire les sources autorisées avec :

trackica skill creation-issues <session-id> --offset 0
trackica skill creation-issue <session-id> <issue-id>
trackica skill creation-issue <session-id> <issue-id> --comments --offset 0

L’agent renvoie un brouillon complet dans un bloc <skill_draft> contenant les champs JSON name, description, content (le SKILL.md complet avec un frontmatter cohérent) et files (path/content). La description indique quand utiliser le skill ; elle ne crée aucun déclenchement automatique. Seule votre confirmation enregistre ces fichiers, avec vous comme créateur et l’exécutant choisi comme association par défaut.

Exécuter avec un agent sélectionné

Toutes les méthodes de création permettent de choisir un Agent d’exécution et un niveau de réflexion. Le créateur ou un administrateur de l’espace peut modifier ou supprimer cette association sur la page du skill. La conversation de création utilise la même sélection que celle enregistrée pour les exécutions ultérieures ; elle ne modifie pas les paramètres globaux de l’agent.

L’association d’exécution sert aux invocations indépendantes explicites par la CLI. Un agent auquel le skill est rattaché en permanence reçoit une instruction de routage et peut l’invoquer avec :

trackica skill run <skill-id> --issue <issue-id> --prompt-file ./request.md --key <unique-request-key>
trackica skill run-get <run-id>
trackica skill run-cancel <run-id>

Chaque invocation démarre une session indépendante sur la même tâche avec un instantané du skill et de ses fichiers, le titre et la description de la tâche, les commentaires pertinents et le texte déclencheur. Le responsable ne change pas. L’exécutant n’a pas besoin que le skill lui soit rattaché en permanence. Le résultat apparaît une seule fois dans le fil déclencheur ; un agent appelant reçoit une suite après la fin de son exécution actuelle. L’invocation est asynchrone : soumettez-la, puis terminez votre tour au lieu d’attendre en occupant une capacité d’exécution.

Les mêmes règles d’accès que pour les mentions d’agents s’appliquent. Une association privée inaccessible se rabat sur l’agent de la tâche actuelle lorsque cette cible peut être déterminée sans ambiguïté. Les autres refus de permission, runtimes absents, niveaux de réflexion non pris en charge et exécutants occupés produisent un échec visible. Annuler la source arrête ses invocations en cours et empêche leur résultat de la relancer.

L’exécutant soumet son résultat avant de terminer l’exécution :

trackica attachment upload ./report.pdf
trackica skill submit <run-id> --file ./result.json

Les résultats d’exécution utilisent {"output":"Texte du résultat"}. Les chemins annexes doivent être relatifs et ne peuvent pas remplacer SKILL.md. Seule la tâche d’exécution authentifiée peut soumettre un résultat. La plateforme publie le résultat et joint les fichiers téléversés après la fin de la tâche.

Un skill sans association conserve son comportement existant. Mettre à jour ou remplacer un contenu importé préserve l’association d’exécution ; les métadonnées de fichiers externes ne peuvent pas la modifier. Les invocations de skills nécessitent un serveur, une CLI et un daemon à jour prenant en charge skill-runs-v1.

Mettre à jour un skill importé

Un skill importé depuis GitHub, ClawHub ou Skills.sh conserve une référence à sa source. Pour récupérer la dernière version, utilisez Mettre à jour sur la page du skill (ou « Mettre à jour depuis la source » dans le menu de la ligne, dans la liste), ou le CLI :

trackica skill refresh <skill-id>

Le skill est retéléchargé depuis sa source et remplacé sur place :

• Conservé : l'identité du skill — rattachements aux agents, association d’exécution et niveau de réflexion, étiquettes, créateur et date de création. Les agents conservent le skill sans avoir à le rajouter.
• Remplacé : le nom (si la source l'a renommé), la description, SKILL.md et tous les fichiers annexes. Les modifications locales du skill sont écrasées.

Le créateur du skill ainsi que les owner et admin de l'espace de travail peuvent mettre à jour depuis la source. Les skills créés manuellement, importés depuis un fichier d'archive ou copiés depuis un runtime n'ont pas de source hébergée et ne peuvent pas être mis à jour de cette façon — réimportez-les.

Pour mettre à jour plusieurs skills à la fois, sélectionnez-les dans la liste des skills et choisissez Mettre à jour dans la barre d'outils de sélection. Chaque skill sélectionné disposant d'une source hébergée est retéléchargé depuis celle-ci ; les autres sont ignorés.

Contenu d'un skill

Chaque skill contient un fichier principal, SKILL.md. Précisez-y :

• quand le skill s'applique ;
• ce qu'il faut vérifier avant de commencer ;
• les étapes à exécuter ;
• la forme que doit prendre le résultat ;
• quand s'arrêter pour consulter un membre.

Vous pouvez aussi ajouter des fichiers annexes, par exemple :

SKILL.md
references/api-conventions.md
templates/review-report.md
scripts/check.sh

SKILL.md est un chemin réservé ; un fichier annexe ne peut pas porter ce nom. Les fichiers annexes sont transmis à l'agent avec le fichier principal.

Utiliser un skill partagé pour un seul tour

Dans une conversation ou un commentaire de tâche sur le web ou l’application de bureau, tapez / et choisissez un skill de la bibliothèque de l’espace de travail. Envoyez-le avec votre demande. L’agent de la conversation, ou celui appelé par le commentaire, reçoit les instructions et les fichiers du skill pour cette invocation. Vous n’avez pas besoin de rattacher d’abord le skill à l’agent.

Cette sélection explicite prime sur l’agent d’exécution par défaut du skill : c’est l’agent actuel qui réalise le travail. Elle ne modifie ni les rattachements permanents, ni l’exécutant par défaut, ni les réglages du modèle. Les tours suivants ne reçoivent pas automatiquement ce skill. Les commentaires de tâche conservent les règles habituelles de mention et d’attribution ; /note empêche toujours le déclenchement d’un agent.

Les sélections sont vérifiées dans l’espace de travail courant à l’envoi et au chargement. Si un skill sélectionné a été supprimé, retirez-le et choisissez-en un disponible. Les skills d’un dépôt ou locaux à un runtime doivent d’abord être importés dans l’espace de travail pour apparaître dans ce sélecteur.

Rattacher un skill à un agent

Pour qu’un agent dispose d’un skill par défaut, choisissez les agents sur la page du skill ou gérez les rattachements dans l’onglet Skills de l’agent. Le rattachement permanent est facultatif pour les sélections ponctuelles décrites ci-dessus.

• Un agent peut utiliser plusieurs skills ;
• un skill peut servir plusieurs agents ;
• lorsqu'un skill n'est pas utile pour le moment, désactivez le rattachement au lieu de supprimer le skill ;
• les modifications s'appliquent aux exécutions suivantes et ne changent pas les exécutions déjà en cours.

Seuls les membres autorisés à modifier l'agent peuvent ajouter, retirer ou désactiver ses skills.

Skills de l'espace de travail et skills du dépôt

Les skills de l'espace de travail sont stockés dans trackica — idéal pour les skills que l'équipe maintient ensemble et ajoute à différents agents.

Certains outils de codage IA lisent aussi des skills au niveau du projet directement depuis le dépôt de code, comme .claude/skills/ ou .agents/skills/. Ces fichiers restent gérés par le dépôt ; trackica ne les enregistre pas automatiquement comme skills de l'espace de travail. La prise en charge dépend de l'outil utilisé — voir Comparatif des outils de codage IA.

Les skills locaux au runtime déjà installés sur un ordinateur connecté (Claude Code et Codex) apparaissent dans l'onglet Skills de l'agent et peuvent être désactivés agent par agent. Cette désactivation requiert également le droit de modifier l'agent.

Droits de modification

Tout membre de l'espace de travail peut créer ou importer un skill. Le créateur ainsi que les owner et admin de l'espace de travail peuvent le modifier ou le supprimer ; les autres membres peuvent le consulter et l'utiliser, mais pas écraser son contenu.

La suppression est définitive et retire le skill de tous les agents en même temps.

Étapes suivantes

• Squads — laissez un chef choisir le bon membre pour le travail.
• Daemon et runtimes — comment les skills atteignent l'environnement d'exécution réel.
• Comparatif des outils de codage IA — comment les différents outils prennent en charge les skills.