Tutoriel sur les compétences

Les Skills sont essentiellement des manuels opératoires qui apprennent à l'IA à faire les choses selon un processus fixe. Une fois écrits, ils peuvent être appelés de manière répétée comme des fonctions.

On peut considérer les Skills commeLa façon de faire professionnellement un certain type de choseCe « savoir-faire » est encapsulé dans un module de capacité réutilisable et déclenché automatiquement.

Les Skills existent sous forme de fichiers Markdown. Ils n'exécutent pas de fonctions ; au lieu de cela, grâce à un chargement à la demande et progressif, ils assurent un transfert de connaissances efficace et réutilisable.

La plus grande différence entre les Skills et les prompts traditionnels est : le chargement à la demande + la divulgation progressive (on n'insère la SOP volumineuse dans le contexte que lorsque c'est nécessaire, ce qui économise beaucoup de tokens).

Élément de comparaison	Prompt ordinaire	Mécanisme des Skills
Doit être redécrit à chaque fois	Oui	Non (décrit une seule fois)
Utilisation de la longueur du contexte	Chargement complet à chaque fois	Chargement progressif (ne lit le contenu complet que lorsqu'il est déclenché)
Cohérence	Dépend de la qualité de chaque prompt	Élevé (SOP fixe + modèles)
Réutilisabilité	Copie et collage manuels	Correspondance automatique / commandes slash / partage de projet
Méthode de maintenance	Chaque modification de prompt nécessite un nouvel envoi	Modifier le fichier SKILL.md ; prend effet globalement/pour le projet

Par exemple, lorsque nous écrivons habituellement des articles, avant les Skills, nous devions répéter les étapes suivantes à chaque fois :

帮我总结文章 → 翻译 → 改成公众号风格 → 加标题 → 输出 Markdown

Avec les Skills :

Il vous suffit d'une seule phrase :

使用「技术文章转公众号」Skill

L'IA exécutera automatiquement en suivant les étapes que vous avez définies.

Imaginez l'IA comme unUn stagiaire récemment diplômé, intelligent mais inexpérimenté：

• Prompt ordinaire= Vous devez lui apprendre à faire les choses à partir de zéro à chaque fois (former une fois aujourd'hui, reformer demain)
• Règle / Mémoire= Vous affichez un "code de conduite d'entreprise" à son poste de travail (toujours en vigueur, mais ne régit que l'attitude et le format)
• MCP / Outils= Vous installez tout un tas de logiciels et d'API sur son ordinateur (il peut appeler des outils externes, mais ne sait pas quand les utiliser ni comment les combiner)
• Skills= Vous lui donnez directement tout un ensemble"Pack de formation professionnelle"(PDF + organigramme + SOP + modèles de scripts de dialogue + scripts courants), et vous lui dites : "Quand le patron vous demande de faire ce genre de chose, suivez les méthodes indiquées dans ce dossier."

Clients courants qui prennent actuellement en charge les Skills :

Classement	Nom de l'outil	Si les Skills sont gratuits à l'utilisation	Utilisateurs recommandés	Chemin par défaut de stockage des Skills	Notes
1	Claude Code	Oui (officiel)	Tout le monde	~/.claude/skills	Définit la norme, écosystème le plus complet
2	Cursor	Oui	Le plus couramment utilisé pour la programmation	~/.cursor/skills	Presque parfaitement compatible avec Claude Skills
3	Trae / OpenCode	Oui	Personnes en quête d’un bon rapport qualité-prix	Dépend des paramètres de l’outil	Plus d’utilisateurs en Chine
4	VS Code + Plugin	Prise en charge partielle	Utilisent déjà intensivement VS Code	Configurer dans les paramètres du plugin	Rattrapage rapide
5	Coze / autres plateformes chinoises	Prise en charge partielle	Préférer la version web	La plateforme est livrée avec une place de marché de Skills	Certains nécessitent une adhésion

La différence entre les Skills et MCP :Les Skills servent àla réutilisation des connaissances, MCP sert àl'extension des capacités。

---

La structure de base d'un Skill

Le cœur des compétences est :Un dossier + un fichier SKILL.md。

Le fichier SKILL.md contient :

• Métadonnées (au moins un nom et une description)
• Des instructions indiquant à l'IA comment accomplir une tâche spécifique

Un Skill est essentiellement un fichier Markdown (nom de fichier fixé à SKILL.md)

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

Modèle de base de SKILL.md :

---
name: pdf-processing
description: 从 PDF 中提取文本和表格，填写表单，并合并文档
---

# PDF 处理

## 使用场景
当需要对 PDF 文件进行操作时使用，例如：

- 提取 PDF 文本或表格数据
- 填写 PDF 表单
- 合并多个 PDF 文件

## 提取文本
- 使用 `pdfplumber` 提取文本型 PDF 内容  
- 扫描版 PDF 需配合 OCR 工具  

## 填写表单
- 读取 PDF 表单字段  
- 按输入数据填充并生成新文件  

Exemple minimal requis :

---
name: skill-name
description: 说明该 Skill 的功能以及适用场景
---

Exemple avec champs facultatifs :

---
name: pdf-processing
description: 从 PDF 中提取文本和表格，填写表单，并合并文档
license: Apache-2.0
metadata:
  author: example-org
  version: "1.0"
---

Champ	Requis	Description
name	Oui	Nom du Skill, jusqu'à 64 caractères, ne peut utiliser que des lettres minuscules, des chiffres et-, et ne peut ni commencer ni se terminer par-le début ou la fin
description	Oui	Description des fonctionnalités et des scénarios d'utilisation, jusqu'à 1024 caractères, ne peut pas être vide
license	non	Nom de la licence ou pointeur vers le fichier de licence fourni avec le Skill
compatibilité	non	Description de l'environnement et des dépendances (produits, paquets système, autorisations réseau, etc.), jusqu'à 500 caractères
metadata	non	Paires clé-valeur personnalisées pour étendre les métadonnées (par exemple, auteur, version)
allowed-tools	non	Liste des outils autorisés (séparés par des espaces, fonctionnalité expérimentale)

Si vous avez besoin de documents de référence, d'exemples de référence ou de scripts d'exécution, vous pouvez utiliser la structure de répertoires d'une compétence plus complexe :

my-skill/
├── SKILL.md      # 必需：指令 + 元数据
├── scripts/      # 可选：可执行代码
├── references/   # 可选：文档资料
└── assets/       # 可选：模板、资源

Fonctionnement des compétences

Les compétences utilisent le chargement progressif pour gérer efficacement le contexte :

• Découverte :Au démarrage, l'IA ne charge que le nom et la description de chaque compétence, en conservant uniquement les informations d'identification les plus élémentaires.
• Activation :Lorsqu'une tâche correspond à la description d'une compétence, l'IA charge les instructions complètes de SKILL.md dans le contexte.
• Exécution :L'IA exécute conformément aux instructions, en chargeant des fichiers de référence ou en exécutant du code à la demande.

Cette conception permet à l'IA de rester rapide tout en lui permettant de récupérer davantage d'informations à la demande.

---

Compétences de Claude Code

Ensuite, prenons Claude Code comme exemple pour créer une compétence simple.

Claude Code recherche et charge les compétences dans l'ordre suivant (plus l'emplacement est spécifique, plus la priorité est élevée) :

Niveau	Chemin	Portée effective
Entreprise	Configuré via la console d’administration (paramètres gérés)	Tous les utilisateurs de l'organisation
Personnel	~/.claude/skills/<skill-name>/SKILL.md	Tous vos projets
Projet	.claude/skills/<skill-name>/SKILL.md	Uniquement le projet actuel
Plugin	<plugin>/skills/<skill-name>/SKILL.md	Environnements où ce plugin est activé

Chaque Skill est un dossier, et le nom du dossier est l’identifiant du Skill (kebab-case, minuscules + tirets, recommandé).

Structure minimale :

~/.claude/skills/
  └── code-comment-expert/          # 技能文件夹名
      └── SKILL.md                  # 唯一必填文件（必须全大写 + .md 小写）

Format complet de SKILL.md :

---                                 #  YAML frontmatter 开始（顶格）
name: code-comment-expert           # 必填：技能名（也是 /slash 命令名）
description: >-                     # 必填：最关键一行！Claude 靠它判断是否加载
  为代码添加专业、清晰的中英双语注释。
  适合缺少文档、可读性差、需要分享审查的代码。
  常见触发场景：加注释、注释一下、加文档、explain this、improve readability

trigger_keywords:                   # 强烈推荐（大幅提升自动触发率）
  - 加注释
  - 注释
  - 加文档
  - explain code
  - document
  - comment this
  - readability

version: 1.0                        # 可选
author: yourname                    # 可选
---                                 # ← YAML 结束

# 这里开始是正文（Markdown）—— Claude 真正执行时的指令

你现在是「专业代码注释专家」。

## 核心原则
- 只在缺少注释或可读性明显不足处添加
- 优先使用英文 JSDoc / TSDoc 风格
- 复杂逻辑 / 非明显意图处额外加一行中文解释
- 注释精炼，每行不超过 80 字符
- 绝不修改原有逻辑

## 输出格式（严格遵守）
1. 先输出完整修改后的代码块（用 ```语言 包裹）
2. 再用 diff 形式展示只改动注释的部分
3. 最后说明加了哪些注释、理由

现在直接开始处理用户提供的代码，不要闲聊。

Structure de fichiers avancée (recommandée lorsque les Skills deviennent complexes)

Lorsqu’un Skill dépasse 500–800 lignes, ou nécessite des modèles/scripts/documents de référence, l’organisation suivante est recommandée :

~/.claude/skills/react-component-review/
  ├── SKILL.md                  # 核心指令 + 元数据（建议控制在 400 行内）
  │
  ├── templates/                # 常用模板（Claude 按需读取）
  │   ├── functional.tsx.md
  │   └── class-component.md
  │
  ├── examples/                 # 优秀/反例（给 Claude 看标准）
  │   ├── good.md
  │   └── anti-pattern.md
  │
  ├── references/               # 规范、规则、禁用词表
  │   ├── hooks-rules.md
  │   └── naming-convention.md
  │
  └── scripts/                  # 可执行脚本（需开启 code execution）
      ├── validate-props.py
      └── check-cycle-deps.sh

Exemple de référencement dans SKILL.md :

Markdown需要给出标准函数组件时，参考 templates/functional.tsx.md 的结构。

如果违反 Hooks 规则，对照 references/hooks-rules.md 第 3–5 条说明。

如需校验 propTypes，可执行 scripts/validate-props.py "{代码片段}"。

Une fois que Claude voit la référence du chemin, il charge le fichier correspondant à la demande, plutôt que de tout entasser dans le contexte d’un coup, ce qui permet d’économiser grandement des tokens.

---

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 sont stockés dans~/.claude/skills/(global personnel) ou sous le répertoire du projet.claude/skills/(spécifique au projet).

Cette section teste sous le répertoire du projet. Tout 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 démarrer 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 en fonction des exigences dans SKILL.md :

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

Ajouter des fichiers de ressources (facultatif)

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

Ajoutez dans le même dossier :

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

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

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

---

Compilation de ressources liées à Agent Skills

Description de la ressource	Lien
Entrée d'agrégation des Skills	https://skills.sh/
Place de marché des Skills (interface chinoise)	https://skillsmp.com/zh
Place de marché des Skills de Tencent	https://skillhub.tencent.com/
Site officiel de la norme Agent Skills	https://agentskills.io
Article d'ingénierie officiel d'Anthropic (concepts pratiques des Agent Skills)	https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
Documentation de VS Code Copilot Agent Skills	https://code.visualstudio.com/docs/copilot/customization/agent-skills
Dépôt GitHub officiel des Skills d'Anthropic	https://github.com/anthropics/skills
Liste sélectionnée de compétences Claude (série Awesome)	https://github.com/ComposioHQ/awesome-claude-skills
Collection de compétences pour les workflows d'automatisation du développement logiciel	https://github.com/obra/superpowers
Une compétence qui génère automatiquement des compétences (exemple officiel)	https://github.com/anthropics/skills/tree/main/skills/skill-creator

Compétences recommandées :

Compétence	Fonction principale	Commande d'installation
find-skills (vercel-labs)	Centre de recherche et de recommandation de compétences	npx skills add vercel-labs/skills
vercel-react-best-practices	Normes d'optimisation des performances React / Next	npx skills add vercel-labs/agent-skills --skill vercel-react-best-practices
frontend-design (anthropics)	Capacité de conception d'interface utilisateur de haute qualité	npx skills add anthropics/skills --skill frontend-design
web-design-guidelines	Normes d'accessibilité web et d'expérience utilisateur (UX)	npx skills add vercel-labs/agent-skills --skill web-design-guidelines
remotion-best-practices	Bonnes pratiques de production vidéo React	npx skills add remotion-dev/skills --skill remotion-best-practices
Remue-méninges (superpowers)	Capacité de réflexion structurée et de planification	npx skills add obra/superpowers --skill brainstorming
agent-browser	Contrôle de l'automatisation du navigateur	npx skills add vercel-labs/agent-browser
browser-use	Interaction avec le navigateur à haute performance	npx skills add browser-use/browser-use
supabase-postgres-best-practices	Optimisation Supabase / PostgreSQL	npx skills add supabase/agent-skills --skill supabase-postgres-best-practices
azure-cost-optimization	Optimisation des coûts du cloud Azure	npx skills add microsoft/github-copilot-for-azure --skill azure-cost-optimization
cloudflare/skills	Pratiques pour Workers et l'informatique en périphérie	npx skills add cloudflare/skills
redis/agent-skills	Patterns avancés et anti-patterns Redis	npx skills add redis/agent-skills
vercel-composition-patterns	Standards des patterns de composition React	npx skills add vercel-labs/agent-skills --skill vercel-composition-patterns
vercel-react-native-skills	Bonnes pratiques officielles React Native	npx skills add vercel-labs/agent-skills --skill vercel-react-native-skills
sleek-design-mobile-apps	Guide de design moderne d'applications mobiles	npx skills add sleekdotdesign/agent-skills --skill sleek-design-mobile-apps
ui-skills	Pratiques UI et d'interaction de niveau designer	npx skills add ibelick/ui-skills
pdf (anthropics)	Capacité de génération et d'analyse de PDF	npx skills add anthropics/skills --skill pdf
seo-audit	Audit et optimisation SEO	npx skills add coreyhaines31/marketingskills --skill seo-audit
skill-creator	Capacité de création de compétences personnalisées	npx skills add anthropics/skills --skill skill-creator
code-review-expert	Capacité de revue de code de niveau professionnel	npx skills add sanyuan0704/code-review-expert

Autres extensions