Skills

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 ?

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 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

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

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

Verdent est livré avec un ensemble de Skills intégrés couvrant les flux de travail courants :

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

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

SKILL.md est le fichier central du Skill, contenant un frontmatter YAML et un corps 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

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

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 :

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

Verdent prend en charge trois niveaux de portée pour les Skills :

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

Verdent propose un Skill Store pour parcourir et installer des Skills communautaires et officiels.

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

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

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

@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

@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

Utilisation avancée

Intégrer des scripts dans les Skills

Ajoutez un répertoire scripts/ à votre Skill et référencez les scripts dans SKILL.md :

## 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

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 :

## 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

Voir aussi