> ## Documentation Index
> Fetch the complete documentation index at: https://docs.llmskills.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Comment intégrer les Agent Skills

> Guide d'intégration des Agent Skills : découverte, chargement de métadonnées, activation d'instructions et exécution sécurisée de scripts.

## Approches d'intégration

Les deux principales approches pour intégrer les Agent Skills sont :

**Les agents basés sur le système de fichiers** fonctionnent dans un environnement informatique (bash/unix) et représentent l'option la plus performante. Les Claude Skills sont activées lorsque les modèles émettent des commandes shell comme `cat /path/to/my-skill/SKILL.md`. Les ressources regroupées sont accessibles via des commandes shell.

**Les agents basés sur des outils** fonctionnent sans environnement informatique dédié. À la place, ils implémentent des outils permettant aux modèles de déclencher des Claude Skills et d'accéder aux ressources regroupées. L'implémentation spécifique de l'outil appartient au développeur.

## Aperçu

Un agent compatible avec les Agent Skills doit :

1. **Découvrir** les Claude Skills dans les répertoires configurés
2. **Charger les métadonnées** (nom et description) au démarrage
3. **Faire correspondre** les tâches utilisateur aux Agent Skills pertinentes
4. **Activer** les Agent Skills en chargeant les instructions complètes
5. **Exécuter** des scripts et accéder aux ressources au besoin

## Découverte des skills

Les Claude Skills sont des dossiers contenant un fichier `SKILL.md`. Votre agent doit analyser les répertoires configurés pour trouver des Agent Skills valides.

## Chargement des métadonnées

Au démarrage, analysez uniquement le frontmatter de chaque fichier `SKILL.md`. Cela permet de maintenir une faible utilisation du contexte initial.

### Analyse du frontmatter

```
function parseMetadata(skillPath):
    content = readFile(skillPath + "/SKILL.md")
    frontmatter = extractYAMLFrontmatter(content)

    return {
        name: frontmatter.name,
        description: frontmatter.description,
        path: skillPath
    }
```

### Injection dans le contexte

Incluez les métadonnées de l'Agent Skill dans le prompt système afin que le modèle sache quels Claude Skills sont disponibles.

Suivez les conseils de votre plateforme pour les mises à jour des prompts système. Par exemple, pour les modèles Claude, le format recommandé utilise XML :

```xml theme={null}
<available_skills>
  <skill>
    <name>pdf-processing</name>
    <description>Extrait le texte et les tableaux des fichiers PDF, remplit des formulaires, fusionne des documents.</description>
    <location>/path/to/skills/pdf-processing/SKILL.md</location>
  </skill>
  <skill>
    <name>data-analysis</name>
    <description>Analyse des jeux de données, génère des graphiques et crée des rapports de synthèse.</description>
    <location>/path/to/skills/data-analysis/SKILL.md</location>
  </skill>
</available_skills>
```

Pour les agents basés sur le système de fichiers, incluez le champ `location` avec le chemin absolu vers le fichier SKILL.md. Pour les agents basés sur des outils, la localisation peut être omise.

Gardez les métadonnées concises. Chaque Claude Skill devrait ajouter environ 50 à 100 tokens au contexte.

## Considérations de sécurité

L'exécution de scripts dans les Claude Skills introduit des risques de sécurité. Considérez :

* **Sandboxing** : Exécutez les scripts dans des environnements isolés
* **Allowlisting** : Exécutez uniquement des scripts provenant de Claude Skills de confiance
* **Confirmation** : Demandez aux utilisateurs avant d'exécuter des opérations potentiellement dangereuses
* **Logging** : Enregistrez toutes les exécutions de scripts pour l'audit

## Implémentation de référence

La bibliothèque [skills-ref](https://github.com/agentskills/agentskills/tree/main/skills-ref) fournit des utilitaires Python et une CLI pour travailler avec les Claude Skills.

Par exemple :

**Valider un répertoire d'Agent Skill :**

```
skills-ref validate <path>
```

**Générer le XML `<available_skills>` pour les prompts d'agent :**

```
skills-ref to-prompt <path>...
```

Utilisez le code source de la bibliothèque comme implémentation de référence.