Aller au contenu

Installer et gérer des skills

Ce guide vous montre comment remplir un espace de travail avec des skills venus de GitHub : ajoutez un dépôt comme source, installez les skills que vous voulez en tirer, et tenez-les à jour au fil du temps.

Ce qu’il faut savoir avant de commencer : un dépôt source n’est pas digne de confiance. Son nom, sa description et son nombre d’étoiles sont écrits par celui à qui il appartient. Le seul signal de sécurité auquel Control Center se fie est le verdict de l’analyse antivirus, par lequel passe chaque installation avant que quoi que ce soit n’atteigne le disque ou le prompt d’un agent. Si vous voulez le raisonnement, lisez la section sur les skills du modèle d’agent ; cette page s’en tient à la pratique.

Les skills se trouvent dans Paramètres → Espace de travail → Compétences (/workspaces/<id>/settings/workspace/skills). Ils sont limités à l’espace de travail : les skills que vous installez ici n’appartiennent qu’à cet espace. La page comporte deux onglets : Installées (les skills locaux, dont un éditeur Nouvelle compétence) et Sources (les catalogues GitHub). Les deux écritures passent par le même filtre d’analyse.

  1. Ouvrez Paramètres → Espace de travail → Compétences et basculez vers l’onglet Sources.
  2. Appuyez sur Ajouter un dépôt.
  3. Collez l’URL d’un dépôt GitHub, par exemple https://github.com/anthropics/skills, et confirmez.

Le serveur vérifie que le dépôt existe et qu’il est visible avec ses identifiants, puis l’ajoute à la barre latérale gauche. Il n’y a aucun magasin curaté au milieu : n’importe quel dépôt GitHub fait l’affaire, ce qui signifie aussi que c’est à vous de juger la réputation — un nombre d’étoiles est un indice, jamais une garantie.

Les skills d’un dépôt sont les répertoires qui contiennent un SKILL.md (jusqu’à trois niveaux de profondeur, plus la disposition du marché de plugins Claude plugins/<plugin>/skills/<skill>, les arborescences de dépendances et de code tiers étant ignorées). Si la grille indique ensuite que le dépôt n’a aucun skill, c’est exactement ce que cela veut dire : aucun répertoire qu’il contient ne suit la convention des skills.

Sélectionnez un dépôt dans la barre latérale ; ses skills apparaissent sous forme de grille à droite, surmontée d’un champ de filtre qui restreint le catalogue par nom, description ou slug. Cliquez sur une carte pour ouvrir la vue détaillée. Elle affiche trois choses :

  • Le README, rendu en markdown — le README.md du répertoire du skill, ou le corps du SKILL.md lorsqu’il n’y a pas de README.
  • L’aperçu de l’analyse — le verdict (pass, warn ou quarantine), les capacités que déclare le contenu du skill (exécute le shell, écrit des fichiers, accès réseau…) et chaque constat relevé par l’analyseur.
  • Le nombre de fichiers — une installation écrit tout le répertoire du skill, et pas seulement son SKILL.md.

L’aperçu analyse exactement les octets qu’une installation écrirait, donc le verdict que vous voyez est celui que l’installation recevra ; rien n’est réévalué dans votre dos.

  1. Ouvrez la vue détaillée du skill.
  2. Lisez le verdict d’analyse. Pour un verdict warn ou pass, appuyez sur Installer.
  3. Pour un verdict quarantine, l’installation reste désactivée jusqu’à ce que vous cochez Je comprends le risque — installer quand même. Ce forçage est consigné, pas présumé.

L’installation écrit le répertoire du skill dans l’espace de travail, enregistre une épingle dans skills-lock.json (dépôt source, chemin, le commit d’origine et un hachage de contenu), et le skill devient disponible pour les agents de l’espace de travail. Une carte marquée Nom déjà utilisé signifie qu’un autre skill possède déjà ce nom en local — désinstallez-le d’abord.

Les cartes des skills installés portent des badges : Installé, ou Mise à jour disponible lorsque le dépôt a dépassé le commit que vous avez épinglé. Ouvrez la vue détaillée et appuyez sur Mettre à jour pour récupérer le skill au nouveau commit. Une mise à jour passe par le même filtre d’analyse qu’une installation — un skill dont la nouvelle version est mise en quarantaine est refusé et la version que vous aviez reste en place. Le hachage de l’ancienne version est conservé comme référence de retour arrière dans le fichier de verrouillage.

Désinstaller (dans la vue détaillée d’un skill installé, ou par suppression dans l’onglet Installées) retire ensemble le répertoire du skill et son épingle de verrouillage — un skill désinstallé ne laisse rien derrière lui.

Supprimer un dépôt de la barre latérale ne retire que le catalogue : les skills que vous en avez installés restent installés et continuent de se mettre à jour, car une épingle enregistre le dépôt par son nom plutôt que par une référence à l’entrée source. Rajoutez le dépôt si vous voulez le parcourir de nouveau.

Les skills s’invoquent sous leur propre espace de noms, de sorte qu’ils n’entrent jamais en collision avec les commandes slash intégrées (/plan, /goal, /loop, /compact) :

  • /skill:<name> — un skill installé dans cet espace de travail, ou attaché à l’agent
  • /skill:<repo>:<name> — un skill fourni par un dépôt extrait dans cet espace

Un nom nu qui n’est pas une commande intégrée se résout quand même, pour les messages écrits avant l’existence de l’espace de noms. /skill:plan est ce qui atteint un skill nommé plan ; /plan est toujours la commande intégrée.

Un dépôt extrait peut fournir ses propres skills, dans .agents/skills/, .agent/skills/, .claude/skills/, .opencode/skills/ ou skills/. Ceux-là ne s’installent pas via cette page. Un agent ne porte que les skills du dépôt dans lequel il travaille actuellement ; ils sont échangés lorsqu’il change de dépôt. Le compositeur n’est pas limité de cette façon : /skill:<repo>:<name> atteint n’importe quel dépôt de l’espace.

Les skills de dépôt passent la même analyse à échec fermé (pass / warn / quarantine) avant que leur frontmatter n’atteigne un prompt. warn est admis ; quarantine est retenu, sans forçage par l’opérateur sur ce chemin.

Voir Skills limités à un dépôt et Commandes slash.