Aller au contenu principal

Compétences

Une compétence est un ensemble nommé d’instructions Markdown que le modèle ne charge que lorsqu’il en a besoin. Chaque compétence possède un slug ($docs-style), un nom d’affichage, une courte description et les instructions complètes.

Chargement à la demande​

La description constitue le manifeste : lorsque les outils sont activés pour un tour, l’outil intégré load_skill répertorie le slug, le nom et la description de chaque compétence activée, puis le modèle récupère les instructions complètes en un seul appel. Les longues instructions n’occupent donc jamais le contexte avant leur utilisation. Mentionner $slug dans un message incite le modèle à charger cette compétence.

Cycle de vie​

Les compétences peuvent être désactivées sans être supprimées ; une compétence désactivée disparaît du manifeste et refuse de se charger. Une mise à jour augmente la version et archive la révision précédente ; une restauration rétablit toute révision sous forme de nouvelle version. Le format d’échange est un document SKILL.md : un frontmatter contenant le nom, le slug et la description, suivi des instructions Markdown à l’identique. L’exportation le télécharge et l’importation l’accepte avec l’enveloppe JSON. Les noms, descriptions et instructions sont chiffrés au repos ; le slug reste en clair.

Importation depuis une boutique​

Les compétences peuvent être récupérées directement depuis une source distante sous Paramètres → Compétences → Depuis une URL. Les formats acceptés sont : un lien de fiche skills.sh, un dépôt GitHub ou une URL d’arborescence ou de blob, une forme abrégée owner/repo/skill (résolue selon la disposition conventionnelle skills/<name>/SKILL.md) ou un lien direct vers n’importe quel fichier SKILL.md. La récupération passe par la même protection de sortie épinglée que les serveurs d’outils : seules les adresses publiques sont autorisées et la taille est limitée. Le document devient votre propre compétence modifiable ; une source distante ne se met donc jamais à jour silencieusement.

Fichiers inclus​

Une compétence peut contenir des fichiers complémentaires selon la disposition du dossier SKILL.md : documents de référence, modèles et sources de scripts mentionnés par les instructions. load_skill répertorie l’ensemble à la fin des instructions et le modèle lit un fichier à la demande avec l’outil read_skill_file ; une référence volumineuse n’occupe donc jamais le contexte avant d’être réellement nécessaire.

Les fichiers accompagnent la compétence partout : Paramètres → Compétences → Depuis un dossier téléverse un dossier SKILL.md local en une seule étape, une importation distante récupère les fichiers texte voisins du SKILL.md, l’exportation JSON transporte l’ensemble et la fenêtre de modification gère les fichiers un par un. Les chemins sont relatifs et ne peuvent jamais sortir de la compétence ; leur contenu est exclusivement textuel, chiffré au repos et borné (32 fichiers, 200 KB chacun, 1 MB par compétence).

Compétences enseignées​

Les compétences dont le slug commence par taught- ont été créées en démontrant une tâche sur l’écran d’un ordinateur Work : l’enregistrement est compilé de façon déterministe en une procédure en langage naturel, avec des cibles de clic ancrées, des secrets masqués et une portée autorisée dérivée des sites visités par la démonstration. Elle est enregistrée comme compétence ordinaire et bénéficie donc des versions, de la modification et du partage. Les exécutions Work qui emploient l’ordinateur chargent automatiquement les compétences enseignées activées du propriétaire. Après une exécution, un avis « réussite » ou « échec » en un clic sur les pastilles de compétences ajoute une ligne datée à la section Historique de la compétence ; chaque avis crée une version normale, de sorte que l’historique peut être modifié et restauré ici comme toute autre modification.

Approbations exigées​

Une compétence peut porter une exigence d’approbation en plus de ses instructions. Dans l’éditeur de compétences, Toujours demander avant l’active et une liste à cocher sélectionne les outils concernés : run_command, computer_act, delete_file, move_file, message_agent et write_file. Ne cocher aucune case couvre les six.

Tant que la compétence est chargée, qu’elle soit liée au profil ou à la persona du tour, ou chargée en cours de tour avec load_skill, ces outils s’arrêtent pour attendre l’utilisateur avant de s’exécuter, quel que soit le réglage d’approbation propre à l’exécution, et la demande nomme la compétence à l’origine de l’exigence. Une règle enregistrée « Toujours autoriser » ne peut jamais les approuver : la prose des instructions est un conseil que le modèle peut paraphraser, alors que ceci est appliqué au niveau du point de contrôle. Un « Autoriser une fois » ponctuel fonctionne toujours, car il s’agit d’une décision prise sur le moment plutôt que d’une règle enregistrée. Voir les approbations des actions.

Le champ voyage avec la compétence : il fait l’aller-retour via l’exportation et l’importation dans l’enveloppe JSON. La forme d’échange SKILL.md ne transporte que les instructions, si bien qu’une importation en simple markdown retombe sur la valeur par défaut (hérité) et que l’exigence doit être redéfinie.

Une compétence enseignée dont la démonstration a masqué un secret est enregistrée avec ce réglage activé pour computer_act : la rejouer repasse par un territoire que l’utilisateur doit voir, et la frontière posée dans la prose n’a jamais suffi à elle seule.

Partage et profils​

Les compétences sont privées par défaut et peuvent être partagées au moyen du modèle commun d’octroi de ressources. Un profil d’assistant peut lier un sous-ensemble de compétences ; les sessions qui utilisent ce profil ne voient que ces compétences dans le manifeste.

Exemple​

Créez une compétence sous Paramètres → Compétences (ou choisissez-y l’un des modèles de départ et modifiez-le) :

  • Slug : cite-sources

  • Nom : Cite sources

  • Description : How to cite evidence: numbered references with URLs, no unreferenced claims. (cette ligne est celle que le modèle voit dans le manifeste ; elle doit préciser quand utiliser la compétence)

  • Instructions :

    # Citing sources

    - Every factual claim gets a numbered reference like [1].
    - End with a References section: number, title, URL.
    - If no source exists, say so instead of inventing one.

Activez les outils dans la zone de rédaction et demandez :

Résume les derniers résultats et $cite-sources.

La saisie de $ complète automatiquement les slugs de vos compétences. Le modèle voit cite-sources dans son manifeste, appelle load_skill pour récupérer les instructions ci-dessus et met la réponse en forme en conséquence. Désactivez la compétence sur sa carte : elle disparaît du manifeste sans être supprimée.