Passer au contenu principal

​
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 : 
<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 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.