Agent Skills (Agent Skills)

Agent signifie agent intelligent, et Skills signifie compétences. Agent Skills est un outil essentiel qui transforme les connaissances professionnelles et les spécifications de workflow en actifs réutilisables.

Agent Skills est essentiellement un fichier Markdown modulaire qui peut apprendre aux outils d'IA (tels que Claude, GitHub Copilot, Cursor, etc.) à effectuer des tâches spécifiques, et prend en charge le déclenchement automatique, le partage en équipe et la gestion d'ingénierie, éliminant complètement la saisie répétitive de prompts.

L'essence d'Agent Skills n'est pas un outil, mais :

Une combinaison de normes comportementales + connaissances professionnelles + moment d'utilisation.

Référence de base du contenu Skills :Tutoriel Skills

Forme essentielle :

• Une Skill est un dossier qui doit contenir un fichier SKILL.md (incluant la description et les métadonnées), et peut éventuellement contenir d'autres fichiers de ressources (tels que des scripts, des exemples, des documents de référence).

• Une Skill est un fichier Markdown (SKILL.md) utilisé pour apprendre à Claude à faire les choses à votre façon dans des scénarios spécifiques.

• En substance, cela équivaut à remettre un manuel professionnel à un agent IA. L’IA n’apprend pas à partir de zéro à chaque fois, mais fait automatiquement appel aux connaissances du manuel en fonction de la tâche.

• En bref, auparavant, nous utilisions des prompts pour apprendre à l’IA comment faire les choses ; désormais, avec Agent Skills, nous pouvons empaqueter des prompts + des ressources dans des packs de compétences réutilisables et partageables, ce qui rend l’ensemble plus efficace et fiable.

Comment fonctionnent les Agent Skills

La clé des Agent Skills réside dans la divulgation progressive, chargée en trois couches :

• Couche 1 : Découverte des compétences-- L’IA lit d’abord les métadonnées (nom et description) de toutes les compétences pour déterminer si la tâche est pertinente. Ces métadonnées se trouvent toujours dans le prompt système.
• Couche 2 : Charger les instructions principales-- Si c’est pertinent, l’IA lit automatiquement le contenu du corps de SKILL.md pour obtenir des indications détaillées.
• Couche 3 : Charger les fichiers de ressources-- Lire des fichiers supplémentaires (tels que des scripts, des exemples) uniquement lorsque cela est nécessaire, ou exécuter des scripts via des outils.

Outils et environnements pris en charge

Actuellement pris en charge :

• Claude (Anthropic) : Claude.ai, Claude Code, Agent SDK.
• VS Code + GitHub Copilot : compétences au niveau du projet (.github/skills/) ou compétences au niveau personnel.
• Cursor : compétences au niveau du projet (.cursor/skills/) ou compétences globales, prend en charge l’installation depuis GitHub.
• Autres : en cours d'extension, standard ouvert àhttps://github.com/agentskills/agentskills。

Pourquoi avons-nous besoin de compétences ? Quels problèmes résolvent-elles ?

Les agents IA ordinaires (tels que Claude ou Copilot) sont intelligents, mais ils sont enclins à commettre des erreurs lorsqu'ils manquent de contexte spécifique. Par exemple :

• L'équipe a ses propres normes de codage, mais l'IA doit être rappelée manuellement à chaque fois.
• Pour des processus complexes tels que le traitement de formulaires PDF ou le débogage de GitHub Actions, l'IA peut ne pas connaître les meilleures pratiques.

Agent Skills résout ces problèmes :

• Déclenchement automatique: L'IA charge automatiquement les compétences pertinentes en fonction de la tâche, ce qui élimine le besoin de saisir manuellement de longs prompts.
• Réutilisable et partageable: Créé une fois, utilisé par toute l'équipe ou la communauté, prend en charge le contrôle de version Git.
• Utilisation efficace du contexte: Adopte la divulgation progressive, en ne chargeant que les parties nécessaires pour éviter de saturer la fenêtre de contexte.
• Multiplateforme: La même compétence peut être utilisée dans des outils tels que Claude, VS Code Copilot, Cursor, etc.

Compréhension rapide des concepts fondamentaux

Flux d'exécution de la compétence

• À partir de l'instruction de l'utilisateur, effectuez d'abord une reconnaissance de l'intention de la compétence pour décider s'il faut entrer dans un chemin d'exécution contrôlé.

• Une fois la compétence mise en correspondance, le système charge SKILL.md, établit les autorisations des outils et les limites de comportement, puis raisonne avec le contexte.

• N'appelez des outils externes autorisés que lorsque c'est vraiment nécessaire ; sinon, accomplissez la logique dans le cadre des règles.

• Le résultat final est produit après l'intégration des contraintes, et la prochaine saisie de l'utilisateur déclenche un nouveau cycle du flux complet.

Structure minimale d'une compétence

my-skill/
└── SKILL.md   （唯一必需）

Modèle de base de SKILL.md :

---
name: your-skill-name
description: What it does and when Claude should use it
---

# Skill Title

## Instructions
Clear, concrete, actionable rules.

## Examples
- Example usage 1
- Example usage 2

## Guidelines
- Guideline 1
- Guideline 2

Champs de métadonnées :

Les Skills prennent en charge l'insertion de variables dynamiques dans le contenu :

Par exemple :

---
name: session-logger
description: 记录当前会话活动
---

请将以下内容写入日志文件：

logs/${CLAUDE_SESSION_ID}.log

$ARGUMENTS

Invocation :

/session-logger 用户登录成功

Cela générera effectivement des enregistrements de journal spécifiques à la session.

Composants principaux du fichier SKILL.md

Prenez comme exemple la compétence d'édition de documents PDF de Claude : Claude peut nativement analyser les PDF, mais ne peut pas les manipuler directement (par exemple, remplir des formulaires). Cette compétence comble cette lacune.

• Forme principale :Un répertoire contenant SKILL.md
• Métadonnées requises :Le bloc YAML au début de SKILL.md doit inclure name et description ; il est préchargé dans le prompt système au démarrage.

Compétence multi-fichiers (divulgation progressive)

Mécanisme de divulgation progressive

• Couche 1 : Métadonnées → permet à Claude de juger les scénarios d'application de la compétence sans charger tout le contenu.
• Couche 2 : corps de SKILL.md → après détermination de la pertinence, charger le contexte complet.
• Couche 3+ : Fichiers joints (par ex., forms.md) → référencés à la demande pour garder le fichier principal compact.

Le diagramme suivant montre comment la fenêtre de contexte change lorsqu’un message utilisateur déclenche la compétence :

• État initial : la fenêtre de contexte contient l’invite système, les métadonnées de la compétence et l’instruction utilisateur.
• Appelez l’outil Bash pour lire le SKILL.md cible et déclencher la compétence correspondante.
• Chargez les fichiers auxiliaires selon les besoins (par ex., forms.md).
• Exécutez la tâche de l’utilisateur une fois le chargement terminé.

Structure de répertoire recommandée

Pour éviter l’encombrement du contexte :

• Règles principales →SKILL.md
• Documents détaillés → fichiers séparés
• Logique pratique → exécution de script (non chargée)

Structure recommandée :

my-skill/
├── SKILL.md
├── reference.md
├── examples.md    # 存放示例文件
└── scripts/
    └── helper.py

Votre première Skill

Oublions temporairement le processus de création complexe et commençons parutiliser une Skill prête à l'emploipour découvrir la commodité qu'elle apporte.

Créer un répertoire de Skill

Les Skills se trouvent dans~/.claude/skills/(global personnel) ou dans le répertoire du projet.claude/skills/(spécifique au projet).

Dans ce chapitre, nous testons sous le répertoire du projet. D'abord, créez un répertoire claude-test :

mkdir claude-test

Entrez dans ce répertoire, créez le répertoire skills et les fichiers :

mkdir -p .claude/skills/python-naming-standard

Écrire le fichier de configuration SKILL.md

Créez SKILL.md dans le répertoire. C'est le cerveau de la Skill, indiquant à Claude quand l'utiliser.

---
name: Python 内部命名规范技能
description: 当用户要求重构、审查或编写 Python 代码时，请参考此规范。
---

## 指令
1. 所有的内部辅助函数必须以 `_internal_` 前缀命名。
2. 如果发现不符合此规则的代码，请自动提出修改建议。
3. 在执行 `claude commit` 前，必须检查此规范。

## 参考示例
- 正确：`def _internal_calculate_risk():`
- 错误：`def _calculate_risk():`

Exigences des champs :

• name: Doit utiliser uniquement des lettres minuscules, des chiffres et des traits d'union (64 caractères max)
• description: Brève description de la Skill et quand l'utiliser (1024 caractères max)

Après création, la structure des fichiers est la suivante :

Votre projet devrait maintenant ressembler à ceci :

my-project/
├─ src/
│  └─ test.py              # 项目源码
├─ .claude/
│  ├─ skills/
│  │  └─ hello-world/
│  │     ├─ skill.md       # Skill 定义（YAML + Instructions，机器可执行）
│  │     └─ README.md      # Skill 说明（人类阅读，可选）
│  └─ config.yml           # Claude 项目级配置（可选）
├─ .gitignore
└─ README.md               # 项目整体说明

Ensuite, exécutez la commande suivante dans le terminal pour lancer Claude Code :

claude

Saisissez la tâche :

Help me write a function that calculates user discounts.

Claude analysera les Skills installés, constatera que votre demande concerne « l’écriture de code Python », et correspondra à python-naming-standard.

Il générera le code suivant conformément aux exigences de SKILL.md :

def _internal_get_discount(user_score):
    # 计算逻辑...
    return discount

Ajouter des fichiers de ressources (facultatif)

De plus, nous pouvons ajouter les répertoires suivants sous.claude/skills/:

Dans le même dossier, ajoutez :

• examples/: stocke les fichiers d’exemple.
• references/: stocke les documents de référence.
• scripts/: stocke les scripts exécutables (par ex., Python pour le traitement de PDF).

Référencez-les ensuite dans SKILL.md :

查看示例 commit：./examples/good-commit.txt
运行脚本：使用工具执行 ./scripts/process.py

Place de marché officielle

En plus d'écrire les vôtres, vous pouvez également tirer parti du standard ouvert Agent Skills publié fin 2025 :

• Place de marché officielle : visitezhttps://github.com/anthropics/skillsle dépôt pour télécharger des compétences prédéfinies (par ex., optimiseur React, outils d'optimisation SQL).
• Skill Creator : vous pouvez dire à Claude : "Aide-moi à résumer la logique de configuration Docker que je viens de t'enseigner en une Skill", et il générera automatiquement des fichiers pour vous dans le répertoire correspondant.

Nous pouvons enregistrer ce dépôt comme place de marché de plugins pour Claude Code en exécutant simplement la commande suivante dans Claude Code :

/plugin marketplace add anthropics/skills

Ensuite, vous pouvez utiliser/plugin pour afficher :

Étapes pour installer un ensemble de compétences spécifique :

• Parcourir et installer des plugins

• Sélectionnez la source du plugin anthropic-agent-skills

• Sélectionnez document-skills (compétences documentaires) ou example-skills (compétences d'exemple)

  

• Cliquez sur "Installer maintenant"

  

Nous pouvons également installer directement les deux types de plugins ci-dessus via des commandes :

/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

Remarque :Le répertoire des compétences installé via les plugins se trouve～/claude/plugins/marketplaces/ci-dessous.

Une fois l'installation du plugin terminée, vous devez redémarrer Claude Code.

Lors de son utilisation, il vous suffit de mentionner le nom de la compétence dans l'instruction pour l'invoquer. Par exemple, après avoir installé le plugin document-skills, vous pouvez donner à Claude Code l'instruction suivante :

使用 PDF 技能提取 path/to/some-file.pdf 文件中的表单字段

Ou créez un PPT :

创建一个 Agent Skill 的演示文稿

Vous pouvez voir qu'il a invoqué/document-skills:pptx：

a commencé à générer :

Ressources liées aux Agent Skills