> For the complete documentation index, see [llms.txt](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/creating-content/ai-coding-assistants-and-skillmd.md).
# Assistants de codage IA et skill.md
GitBook fournit un [skill.md](https://gitbook.com/docs/skill.md) fichier qui apprend aux assistants de codage IA à modifier correctement la documentation GitBook. Si vous souhaitez utiliser Claude Code, Cursor, Codex ou un autre assistant de codage externe pour modifier localement des docs GitBook, utilisez le fichier skill.md comme « règles du projet ».
Cela s’intègre bien avec [Git Sync ](/url/gitbook.com/docs/documentation/fr/getting-started/git-sync.md)des flux de travail dans lesquels vous modifiez votre documentation localement puis validez vos modifications pour mettre à jour votre site de documentation. Le fichier de référence couvre les extensions Markdown de GitBook, les blocs personnalisés, les fichiers de configuration et les bonnes pratiques pour les assistants externes.
#### Télécharger
{% file src="/files/668dbe2cc5806303b71a8e03013b5381b5154f0a" %}
{% hint style="info" %}
**Vous préférez rédiger avec l’IA dans l’éditeur GitBook ?**
GitBook propose également [GitBook Agent](/url/gitbook.com/docs/documentation/fr/gitbook-agent/what-is-gitbook-agent.md) pour une documentation assistée par IA directement depuis votre éditeur. Ce guide s’adresse aux équipes qui préfèrent utiliser des assistants de codage externes comme Claude Code ou Cursor.
{% endhint %}
### Ce que contient skill.md
* Référence complète de la syntaxe pour tous les blocs personnalisés
* Formats des fichiers de configuration (`.gitbook.yaml`, `SUMMARY.md`, `.gitbook/vars.yaml`)
* Options de frontmatter et contrôles de mise en page
* Syntaxe des variables et des expressions
* Tableaux de décision pour choisir le bon type de bloc
* Pièges courants et bonnes pratiques
Ajouter ce fichier à votre assistant de codage IA (par ex. Claude Code, Codex, etc.) lui fournit les informations nécessaires sur la création, la modification et la mise en forme du contenu de votre documentation GitBook. Cela signifie que l’assistant suivra les cadres établis et les bonnes pratiques pour les fonctionnalités de GitBook.
### Utilisation de skill.md via URL
La plupart des assistants de codage IA prennent en charge des instructions spécifiques au projet. Vous pouvez référencer le fichier skill dans la configuration de votre projet en fournissant l’URL du fichier skill afin que l’assistant sache comment travailler avec la syntaxe GitBook.
### Utilisation de skill.md en local
Vous pouvez également télécharger le fichier skill et l’inclure dans votre dépôt. Commencez par télécharger skill.md à la racine de votre dépôt, puis référencez-le dans le fichier de règles de votre assistant de codage : `« Lisez skill.md à la racine du dépôt pour la syntaxe et les bonnes pratiques GitBook »` . Cela fonctionne bien avec Claude Code, ChatGPT, Codex et des outils similaires.
Cette approche fonctionne hors ligne et permet des modifications spécifiques à l’équipe.
{% hint style="warning" %}
N’oubliez pas de mettre à jour votre dépôt local avec la dernière version du fichier skill.md à mesure que GitBook ajoute de nouvelles fonctionnalités.
{% endhint %}
### Tester le contenu généré par l’IA
Il est important de toujours relire et tester le contenu généré par des assistants IA — à la fois pour l’exactitude technique et pour la mise en forme correcte.
Lorsque vous travaillez avec des assistants IA entraînés sur le fichier skill, vous devez :
* Vérifier que tous les blocs personnalisés s’affichent correctement dans GitBook
* Vérifier que tous les liens internes fonctionnent
* Confirmer que le frontmatter est un YAML valide
* Vérifier que les variables font référence au bon périmètre
{% hint style="warning" %}
**Remarque :** Les assistants IA peuvent parfois générer une syntaxe incorrecte ou oublier de fermer des blocs personnalisés. Relisez toujours les modifications avant de les valider.
{% endhint %}
### GitBook Agent
Vous préférez travailler directement dans GitBook ? [GitBook Agent](/url/gitbook.com/docs/documentation/fr/gitbook-agent/what-is-gitbook-agent.md) vous offre un flux de travail assisté par IA dans l’éditeur GitBook — que vous utilisiez Git Sync ou non.
L’Agent dispose du contexte complet de votre documentation et est déjà entraîné à utiliser les blocs et les fonctionnalités de GitBook de la meilleure façon possible. L’Agent vous aide à rédiger du contenu, à effectuer des mises à jour et à optimiser votre documentation pour différents cas d’usage, le tout depuis l’application GitBook.
Découvrir GitBook Agent
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/creating-content/ai-coding-assistants-and-skillmd.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.