Système de compétences

Une compétence (Skill) est un module de capacités destiné à l'Agent : un répertoire centré sur un fichier SKILL.md, qui contient des instructions, des scripts et des documents de référence. En lisant ces éléments à la demande lorsqu'il exécute une tâche, l'Agent peut réaliser une action qu'il ne savait pas faire auparavant, par exemple générer un document Word avec table des matières et en-têtes.

Qu'est-ce qu'une compétence

Chaque compétence est un répertoire contenant au minimum un fichier SKILL.md : le frontmatter indique name et description, le corps contient les instructions destinées à l'Agent. Le répertoire peut aussi inclure des pièces jointes (scripts, documents de référence, modèles de configuration) et déclarer des dépendances ainsi que des serveurs MCP.

---
name: weekly-report-style
description: 生成周报 Excel 时统一使用团队的配色与表头规范
---

# 使用说明

正文写给 Agent 看：什么时候用这个技能、
按什么步骤做、附带的脚本和参考文件怎么用。

Les compétences reposent sur une divulgation progressive : l'Agent ne voit habituellement que le nom et la description de chaque compétence, et ne charge le corps complet et les pièces jointes que lorsqu'il estime qu'une compétence est utile à la tâche en cours. Ainsi, même avec de nombreuses compétences installées, tout le contenu n'est pas injecté dans chaque conversation.

Compétences système et compétences installées par l'utilisateur

Les compétences système génériques préinstallées se répartissent principalement en deux catégories : la génération de documents Office (docx / xlsx / pptx / pdf) et les compétences de développement (front-end, full-stack, iOS, Android, Flutter, React Native, etc.). La liste complète est visible sur la page « Gestion des compétences » de la console ; en ouvrant une compétence, vous consultez sa version, ses pièces jointes et le texte intégral de son SKILL.md.

Génération de documents Office

Ce groupe de compétences système permet aux étapes d'Agent de produire directement des fichiers de documents bureautiques, et pas seulement du texte Markdown :

Cas d'usage typique : dans un workflow de rapport quotidien, une étape d'Agent utilise la compétence xlsx pour produire une feuille de rapport hebdomadaire mise en forme, téléchargeable avec les artefacts d'exécution ou envoyée directement sur Slack / par e-mail. Les artefacts peuvent aussi être publiés sous forme de lien public, voirPartage public du produit.

Place de marché des compétences : installation et versions

La page « Place de marché des compétences ClawHub » de la console se connecte au registre ClawHub. Recherchez par mot-clé, consultez la version, l'auteur, le nombre de téléchargements et la date de mise à jour de chaque compétence, puis cliquez sur installer pour l'ajouter à votre compte.

# 搜索市场
curl "https://braidrun.com/api/skills/market/search?query=testing&limit=10" \
  -H "Authorization: Bearer <token>"

# 安装（安装状态只记在你自己的账号下）
curl -X POST https://braidrun.com/api/skills/market/<slug>/install \
  -H "Authorization: Bearer <token>"

# 升级到最新版本
curl -X POST https://braidrun.com/api/skills/market/<slug>/upgrade \
  -H "Authorization: Bearer <token>"

• Les compétences sont versionnées. Pour une compétence installée, cliquez sur « Vérifier les mises à jour » sur la page « Gestion des compétences » ; la mise à niveau retélécharge la dernière version
• Seules les compétences installées depuis la place de marché suivent le processus de mise à niveau ; les compétences importées par ZIP n'ont pas de source de mise à niveau, il suffit de les réimporter
• La désinstallation ne retire l'installation que de votre propre compte, sans affecter les autres utilisateurs ayant installé la même compétence
• Vous pouvez aussi importer vos propres compétences en téléversant directement un ZIP : le paquet doit contenir un fichier SKILL.md avec des champs name et description valides ; la taille totale décompressée ne doit pas dépasser 100MB

Activation / désactivation par utilisateur

Sur la page « Gestion des compétences », chaque compétence dispose de son propre interrupteur. L'état activé / désactivé est enregistré sous votre compte : si vous désactivez une compétence système, elle n'est plus visible pour vos Agents, sans que les autres utilisateurs soient affectés. Les compétences installées en privé par d'autres utilisateurs ne sont ni visibles ni chargées pour vous.

Portée d'Agent : restreindre les compétences qu'un Agent peut utiliser

Au-delà de l'interrupteur au niveau du compte, vous pouvez aussi définir une portée de compétences plus restreinte pour un Agent donné dans sa configuration. Champs courants :

• Interrupteur du sous-système Skills — une fois désactivé, cet Agent n'utilise aucune compétence
• Mode liste blanche — une fois activé, seules les compétences de la liste blanche sont détectables par cet Agent ; les compétences intégrées sont automatiquement ajoutées à la liste blanche
• Liste de désactivation — liste noire, qui reste effective lorsque le mode liste blanche est désactivé
• Nombre maximal de compétences par requête — limite le nombre de compétences injectées dans une seule requête
• Recherche et téléchargement automatiques — désactivé par défaut ; une fois activé, l'Agent recherche et télécharge automatiquement de nouvelles compétences sur ClawHub lorsqu'il constate qu'une capacité manque localement, ce qui introduit des téléchargements externes ; à utiliser avec prudence en contexte d'entreprise

À l'exécution, la plateforme combine la configuration de l'Agent et votre état au niveau utilisateur pour déterminer la portée de compétences finalement effective : une compétence que vous avez désactivée sur la page « Gestion des compétences » est indisponible pour tous les Agents de cette exécution.

Configuration d'exécution

Certaines compétences nécessitent de renseigner au préalable des paramètres ou des identifiants pour fonctionner, par exemple un token API d'un service tiers. Une compétence dotée d'un modèle de configuration affiche « Configuré / À configurer » sur sa carte ; cliquez sur « Configurer Skill » pour renseigner les champs.

• Les champs sensibles (token, mot de passe, clé privée, etc.) sont affichés masqués après enregistrement, sans réafficher le texte en clair ; soumettre en conservant le masque réutilise l'ancienne valeur
• Vous pouvez configurer vous-même les compétences que vous avez installées ; la configuration d'exécution des compétences système ne peut être modifiée que par un administrateur

Endpoints courants

Pages connexes

• Explication détaillée de la configuration de l'agent
• Bibliothèque de modules intégrée
• Partage public du produit