# Skills (/fr/docs/verdent-manager/core-features/skills)
> Étendez les capacités de Verdent avec des packs de connaissances réutilisables pour des flux de travail spécialisés et une expertise métier
Verdent Les **Skills** sont des packs de connaissances réutilisables qui étendent l'expertise de l'agent. Chaque Skill contient des prompts spécifiques à un domaine, des scripts, des références et des bonnes pratiques. Il suffit d'invoquer un Skill par son nom pour que l'agent charge le contexte correspondant et suive le flux de travail prédéfini.
***
## Que sont les Skills ? [#que-sont-les-skills-]
### Concept de base [#concept-de-base]
Un **Skill** est un pack de connaissances structuré, stocké dans un dossier. Chaque Skill contient un fichier `SKILL.md` qui définit son nom, sa description et son prompt détaillé. Lorsque vous invoquez un Skill dans une conversation, Verdent lit ce fichier et injecte son contenu dans le contexte de l'agent.
### En quoi les Skills diffèrent des sous-agents et de MCP [#en-quoi-les-skills-diffèrent-des-sous-agents-et-de-mcp]
| Dimension | Skills | Sous-agents | MCP |
| ------------------ | ----------------------------------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| **Déclenchement** | Invocation manuelle via `@skill` ou mention | Généré automatiquement par l'agent principal | Invoqué automatiquement ou explicitement |
| **Exécution** | Étend le contexte de la conversation principale | S'exécute comme une sous-tâche indépendante avec un contexte isolé | Appelle des outils externes via JSON-RPC 2.0 |
| **Objectif** | Guidance métier (par exemple, « comment écrire des tests ») | Opérations indépendantes (par exemple, « exécuter une revue de code ») | Accès à des données/outils externes (par exemple, requêtes de base de données) |
| **Cycle de vie** | Injection de contexte ponctuelle | Termine la sous-tâche puis renvoie les résultats | Processus serveur persistant pendant la session |
| **Implémentation** | Fichiers Markdown + scripts optionnels | Logique intégrée de l'agent | Processus serveur exécutables |
En résumé : **les Skills fournissent des connaissances et des conseils de flux de travail**, **les sous-agents exécutent des tâches indépendantes**, et **MCP connecte des outils et sources de données externes**.
***
## Comment utiliser les Skills [#comment-utiliser-les-skills]
### Invoquer un Skill [#invoquer-un-skill]
Vous pouvez invoquer un Skill de deux manières :
**1. Mentionner le nom du Skill dans la conversation**
```
Use the skill-creator skill to help me create a new Skill
```
**2. Utiliser la syntaxe de mention @**
```
@skill-creator help me create a Skill for API documentation generation
```
Lorsqu'un Skill est déclenché :
1. L'agent appelle l'outil `skill` pour lire le fichier `SKILL.md` du Skill
2. Le contenu du fichier est injecté dans le contexte de la conversation en cours
3. L'agent poursuit son travail en suivant les indications du Skill
### Parcourir les Skills disponibles [#parcourir-les-skills-disponibles]
Accédez au panneau des Skills via les paramètres :
1. Ouvrez le menu **Paramètres**
2. Sélectionnez l'onglet **Skills**
3. Parcourez les Skills installés et les Skills disponibles dans le Skill Store
Vous pouvez également saisir `@` dans le champ de saisie pour déclencher l'autocomplétion et sélectionner rapidement un Skill disponible.
***
## Skills intégrés [#skills-intégrés]
Verdent est livré avec un ensemble de Skills intégrés couvrant les flux de travail courants :
| Skill | Description |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **docx** | Lire, créer ou modifier des documents Word (`.docx`) avec des vérifications visuelles fidèles au format |
| **find-skills** | Découvrir et installer des Skills — à utiliser lorsque vous vous demandez « comment faire X ? » ou que vous cherchez de nouvelles capacités |
| **frontend-design** | Créer des interfaces frontend distinctives et de qualité production, avec un haut niveau d'exigence en matière de design |
| **pdf** | Lire, créer ou examiner des fichiers PDF avec rendu visuel et extraction de contenu |
| **pptx** | Lire, créer ou modifier des présentations PowerPoint (`.pptx`) |
| **skill-creator** | Un flux de travail guidé pour créer et itérer sur des Skills personnalisés |
| **xlsx** | Lire, analyser, visualiser et modifier intelligemment des feuilles de calcul Excel |
D'autres Skills sont disponibles dans le **Skill Store**. Ouvrez **Paramètres → Skills → Store** pour parcourir et installer des Skills supplémentaires.
***
## Créer des Skills personnalisés [#créer-des-skills-personnalisés]
Vous pouvez créer des Skills personnalisés pour encapsuler l'expertise métier de votre équipe ou des flux de travail spécifiques à votre projet.
### Structure du dossier d'un Skill [#structure-du-dossier-dun-skill]
Un dossier de Skill standard se présente ainsi :
```
my-custom-skill/
├── SKILL.md # Required: Skill definition file
├── agents/
│ └── verdent.yaml # Optional: UI configuration (icons, display name)
├── scripts/ # Optional: helper scripts
└── references/ # Optional: reference docs or examples
```
### Format de SKILL.md [#format-de-skillmd]
`SKILL.md` est le fichier central du Skill, contenant un frontmatter YAML et un corps Markdown :
```markdown
---
name: my-custom-skill
description: A concise description shown in the Skill list
metadata:
version: "1.0.0"
author: "Your Name"
license: "MIT"
---
# Detailed Instructions
This is the detailed prompt content the Agent reads.
## Workflow
1. Step one
2. Step two
3. ...
## Best Practices
- Practice suggestion 1
- Practice suggestion 2
```
**Exigences des champs du frontmatter :**
* `name` (obligatoire) : doit correspondre au nom du dossier. Seuls les lettres minuscules, les chiffres et les tirets (`a-z0-9-`) sont autorisés. Longueur : 1 à 64 caractères. Pas de tirets consécutifs ni en début/fin.
* `description` (obligatoire) : une description courte, de 1024 caractères maximum.
* `metadata` (optionnel) : version, auteur, licence et autres métadonnées.
### Installer des Skills personnalisés [#installer-des-skills-personnalisés]
**Méthode 1 : importer via les paramètres**
1. Ouvrez **Paramètres → Skills**
2. Cliquez sur **Importer un Skill**
3. Sélectionnez le dossier du Skill (ou une archive `.zip` / `.skill`)
4. Verdent valide `SKILL.md` et l'installe dans `~/.verdent/skills/`
**Méthode 2 : copie manuelle**
```bash
cp -r my-custom-skill ~/.verdent/skills/
```
Le Skill devient disponible après redémarrage de Verdent ou actualisation de la liste des Skills.
**Méthode 3 : Skill au niveau du projet**
Placez le Skill dans le répertoire de votre projet :
```bash
cp -r my-custom-skill /path/to/your/project/.verdent/skills/
```
Les Skills au niveau du projet ne sont visibles que dans ce projet et sont prioritaires sur les Skills globaux portant le même nom.
***
## Portées des Skills [#portées-des-skills]
Verdent prend en charge trois niveaux de portée pour les Skills :
| Niveau | Emplacement | Visibilité |
| ---------- | ---------------------------- | ------------------------------------------------ |
| **Global** | `~/.verdent/skills/` | Tous les projets et espaces de travail |
| **Projet** | `/.verdent/skills/` | Espaces de travail du projet en cours uniquement |
**Règles de priorité :**
Lorsque des Skills portant le même nom existent à plusieurs niveaux :
* Le niveau projet prime sur le niveau global
***
## Skill Store [#skill-store]
Verdent propose un **Skill Store** pour parcourir et installer des Skills communautaires et officiels.
### Parcourir le Skill Store [#parcourir-le-skill-store]
1. Ouvrez **Paramètres → Skills**
2. Passez à l'onglet **Store**
3. Parcourez les Skills disponibles ou utilisez le champ de recherche
### Installer depuis le Store [#installer-depuis-le-store]
1. Trouvez le Skill souhaité dans le Store
2. Cliquez sur **Installer**
3. Le Skill est automatiquement téléchargé et installé dans `~/.verdent/skills/`
**Vérification de sécurité :**
Les Skills installés depuis le Store font l'objet d'une vérification par somme de contrôle SHA256 pour garantir l'intégrité et la sécurité des fichiers.
***
## Exemples pratiques [#exemples-pratiques]
### Exemple 1 : créer un nouveau Skill avec `skill-creator` [#exemple-1--créer-un-nouveau-skill-avec-skill-creator]
```
@skill-creator help me create a Skill for guiding the team on writing Go unit tests
```
L'agent va :
1. Lire le contenu du Skill `skill-creator`
2. Vous guider pour renseigner le nom, la description et le prompt central du Skill
3. Générer un fichier `SKILL.md` standard
4. Suggérer le chemin d'installation et les étapes de vérification
### Exemple 2 : analyser des données avec `spreadsheet` [#exemple-2--analyser-des-données-avec-spreadsheet]
```
@spreadsheet read sales-2025.xlsx from the project root, analyze Q1 sales trends, and generate a chart
```
L'agent va :
1. Charger le Skill `spreadsheet`
2. Utiliser `pandas` et `openpyxl` pour lire le fichier Excel
3. Analyser les données et générer des visualisations
4. Enregistrer les résultats ou les afficher dans la conversation
### Exemple 3 : corriger la CI avec `gh-fix-ci` [#exemple-3--corriger-la-ci-avec-gh-fix-ci]
```
@gh-fix-ci my PR #123 GitHub Actions tests are failing, help me debug
```
L'agent va :
1. Utiliser la CLI `gh` pour récupérer les logs CI de la PR #123
2. Analyser l'échec (par exemple, erreurs de cas de test, problèmes de dépendances)
3. Proposer une correction
4. Avec votre approbation, modifier le code et pousser la correction
***
## FAQ [#faq]
Lorsqu'un Skill est invoqué, l'agent lit le fichier `SKILL.md`, ce qui compte dans l'utilisation de tokens et consomme donc des crédits. Cependant, le Skill lui-même ne génère pas d'appels API supplémentaires.
Oui. Installez le Skill dans `~/.verdent/skills/` (portée globale) et il sera disponible dans tous les projets.
Dans **Paramètres → Skills**, faites un clic droit sur le Skill et sélectionnez **Supprimer**. Les Skills intégrés marqués comme `undeletable` ne peuvent pas être supprimés et seront réinstallés au prochain démarrage.
Oui. Verdent détecte automatiquement les Skills dans `~/.cursor/skills`, `~/.claude/skills` et `~/.codex/skills`, et vous invite à les importer. Cliquez sur **Importer depuis des sources externes** dans **Paramètres → Skills**.
* **Règle de projet** : instructions toujours actives, automatiquement injectées dans chaque conversation
* **Skill** : packs de connaissances à la demande, injectés uniquement lors de leur invocation
Utilisez les règles pour des standards de code universels ; utilisez les Skills pour des flux de travail métier spécifiques.
Les Skills installés depuis le Skill Store sont automatiquement vérifiés en arrière-plan pour détecter les mises à jour. Les Skills installés manuellement doivent être réimportés (en écrasant l'ancienne version) pour être mis à jour.
***
## Utilisation avancée [#utilisation-avancée]
### Intégrer des scripts dans les Skills [#intégrer-des-scripts-dans-les-skills]
Ajoutez un répertoire `scripts/` à votre Skill et référencez les scripts dans `SKILL.md` :
```markdown
## Data Processing Script
Run the following command to process data:
\`\`\`bash
python scripts/process_data.py --input data.csv --output results.json
\`\`\`
```
L'agent lit cette instruction et exécute le script selon les besoins.
### Référencer de la documentation [#référencer-de-la-documentation]
Stockez la documentation API, les spécifications ou des exemples de code dans un répertoire `references/` et référencez-les dans `SKILL.md` :
```markdown
## Reference Documentation
See [references/api-spec.md](references/api-spec.md) for the detailed API specification.
```
L'agent peut lire ces fichiers de référence en fonction des instructions du Skill.
***
## Bonnes pratiques [#bonnes-pratiques]
**Gardez les Skills ciblés.** Chaque Skill doit se concentrer sur un seul domaine ou flux de travail. Évitez de créer des Skills « à tout faire » — répartissez-les plutôt en Skills plus petits et spécialisés.
**Utilisez des noms clairs.** Les noms de Skills doivent être concis et descriptifs, par exemple `api-doc-generator` plutôt que `my-skill-1`.
**Fournissez des exemples et des références.** Incluez des exemples concrets et des liens de référence dans `SKILL.md` pour aider l'agent à mieux comprendre le résultat attendu.
**Maintenez les numéros de version.** Utilisez le champ `metadata.version` pour suivre les mises à jour et la compatibilité.
**Testez avant de partager.** Validez votre Skill dans un projet de test avant de le déployer auprès de l'équipe ou de le publier sur le Skill Store.
***
## Voir aussi [#voir-aussi]
Fonctionnement des sous-agents et leur gestion
Connecter des outils et services externes via MCP
Configurer des règles de projet et utilisateur toujours actives
Examiner les modifications de code avec le Reviewer intégré