Passer au contenu principal
Les skills sont des guides Markdown rédigés par votre équipe qui vivent aux côtés de votre documentation. L’assistant voit un catalogue de vos skills dans son prompt système et ne charge le guide complet que lorsque la question d’un utilisateur y correspond clairement. Vous pouvez ainsi fournir des réponses expertes et sélectionnées pour les questions les plus importantes, sans alourdir chaque réponse. Utilisez les skills lorsque :
  • Un sujet nécessite une réponse spécifique et argumentée que les résultats de recherche génériques ne produisent pas de manière fiable.
  • Vous souhaitez encoder des playbooks internes, des flux de dépannage ou des guides de migration qui ne sont pas structurés comme des pages de documentation classiques.
  • Vous souhaitez orienter la manière dont l’assistant guide les utilisateurs à travers des procédures en plusieurs étapes ou nuancées.

​
Ajouter une skill

Créez une skill en ajoutant un fichier skill.md dans un répertoire nommé d’après un slug sous .mintlify/assistant/skills/ : 
.mintlify/
└── assistant/
    └── skills/
        ├── migrate-to-v3/
        │   └── skill.md
        └── debug-webhooks/
            └── skill.md
Chaque fichier skill.md a besoin d’un frontmatter YAML avec un name et une description, suivi du contenu complet du guide :
.mintlify/assistant/skills/migrate-to-v3/skill.md
---
name: Migrate to SDK v3
description: Step-by-step guide for upgrading from SDK v2 to v3, including breaking changes, code mods, and rollout checklist.
---

# Migrating to SDK v3

Follow these steps to upgrade an existing v2 integration to v3.

## 1. Update dependencies

...
L’assistant utilise name et description pour décider s’il doit charger la skill. Rédigez donc des descriptions qui indiquent clairement quand le guide s’applique. Gardez le corps concentré : le contenu d’une skill est tronqué à environ 6 000 tokens lors du chargement.
Les skills sont découvertes lors de votre prochaine mise à jour de la documentation. Après avoir ajouté ou modifié un fichier skill.md, publiez votre documentation pour rendre la skill disponible à l’assistant.

​
Comment l’assistant utilise les skills

  • L’assistant liste toutes les skills disponibles (nom, slug et description) dans son prompt système.
  • Lorsque la question d’un utilisateur correspond à une skill, l’assistant appelle l’outil loadSkill avec le slug de la skill et utilise le guide retourné comme contexte de référence.
  • L’assistant peut charger jusqu’à trois skills par réponse.
  • Le contenu d’une skill chargée est traité comme un conseil rédigé par l’équipe et prévaut sur les résultats de recherche généraux.
  • Lors des tours suivants, le contenu des skills précédemment chargées est retiré de l’historique de la conversation pour maintenir un contexte réduit ; l’assistant recharge une skill s’il en a de nouveau besoin.
Les skills fonctionnent en complément des instructions personnalisées de l’assistant dans .mintlify/Assistant.md. Utilisez Assistant.md pour le ton global, la personnalité et les règles ; utilisez les skills pour des conseils approfondis et spécifiques à un sujet que l’assistant ne doit charger que lorsqu’ils sont pertinents.

​
Conseils de rédaction des skills

  • Donnez à chaque skill une description distincte et non ambiguë. Des descriptions qui se chevauchent rendent plus difficile pour l’assistant le choix de la bonne skill.
  • Utilisez un slug unique et compatible avec les URL pour chaque nom de répertoire. Les slugs ne doivent contenir que des lettres minuscules, des chiffres et des tirets. Les slugs en double sont ignorés avec un avertissement lors de la publication.
  • Structurez les guides avec des titres clairs et des étapes numérotées. Les assistants suivent plus fidèlement un contenu procédural lorsqu’il est explicite.
  • Gardez les guides autonomes. L’assistant ne charge qu’une skill à la fois, elle ne doit donc pas dépendre d’une autre skill pour avoir du sens.
  • Privilégiez la prose et les exemples de code aux captures d’écran. L’assistant ne lit que le corps Markdown.

​
Désactiver les skills

Les skills sont activées par défaut lorsqu’au moins un fichier skill.md est présent. Pour désactiver entièrement les skills pour votre déploiement, contactez le support afin de désactiver la fonctionnalité des skills de l’assistant. Supprimer le répertoire .mintlify/assistant/skills/ et republier vide également le catalogue.

Sujets connexes

skill.mdConfigurer l'assistantAssistant