> For the complete documentation index, see [llms.txt](https://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.com/docs/documentation/fr/getting-started/ai-documentation/ai-coding-assistants-and-skillmd.md). # Compétences de l’agent GitBook fournit [des fichiers de compétences](https://github.com/GitbookIO/gitbook-skills/tree/main) qui apprennent aux assistants de code IA à modifier correctement la documentation GitBook. Si vous utilisez Claude Code, Cursor, Codex ou un autre assistant de code externe, ajoutez les compétences GitBook afin que votre agent puisse travailler avec la syntaxe, les blocs et les fichiers de configuration de GitBook. Cela s'intègre parfaitement aux [flux de travail Git Sync](/docs/documentation/fr/getting-started/git-sync.md) — apportez des modifications dans votre dépôt, validez-les, et votre site de documentation se met à jour automatiquement. {% hint style="info" %} Vous préférez écrire dans l'éditeur GitBook ? Utilisez [GitBook Agent](/docs/documentation/fr/agent-gitbook/what-is-gitbook-agent.md) pour rédiger, réécrire, relire et traduire du contenu sans quitter GitBook. {% endhint %} ## Ajoutez des compétences GitBook à votre agent IA Utilisez cette option lorsque votre assistant de code IA prend en charge les compétences basées sur des paquets. {% stepper %} {% step %} ### Créer un jeton d'accès Pour permettre à votre agent d'interagir avec GitBook, vous devez [créer un jeton d'accès](https://app.gitbook.com/account/developer) depuis les paramètres développeur de GitBook. GitBook utilise ce jeton pour authentifier votre agent lorsqu'il travaille avec les compétences GitBook. {% endstep %} {% step %} ### Installer les compétences GitBook Cette compétence fait partie du [`gitbook-skills`](https://github.com/GitbookIO/gitbook-skills) dépôt. Exécutez la commande suivante pour installer les compétences GitBook directement dans votre projet : {% code expandable="true" %} ```bash npx skills add GitBookIO/gitbook-skills ``` {% endcode %} {% endstep %} {% endstepper %} ## Ajouter les compétences GitBook localement Téléchargez les compétences GitBook si votre assistant ne prend pas en charge les compétences basées sur des paquets. {% stepper %} {% step %} ### Créer un jeton d'accès Pour permettre à votre agent d'interagir avec GitBook, vous devez [créer un jeton d'accès](https://app.gitbook.com/account/developer) depuis les paramètres développeur de GitBook. GitBook utilise ce jeton pour authentifier votre agent lorsqu'il travaille avec les compétences GitBook. {% endstep %} {% step %} ### Télécharger les compétences GitBook Installez les compétences GitBook avec `npx skills add GitBookIO/gitbook-skills` lorsque votre assistant le prend en charge. Pour copier manuellement les fichiers dans votre projet, récupérez les compétences GitBook depuis le [`gitbook-skills`](https://github.com/GitbookIO/gitbook-skills) dépôt.

Compétence	Description	Télécharger
`configure-site`	Créez et maintenez des sites complets de documentation GitBook.	GitHub
`write-docs`	Rédigez, créez, modifiez et mettez en forme des pages de documentation GitBook.	GitHub
`write-openapi`	Rédigez, configurez, structurez et dépannez la documentation de référence API OpenAPI/Swagger.	GitHub
`build-integration`	Créez des intégrations personnalisées pour GitBook.	GitHub
`cr-create`	Créez des demandes de changement GitBook, poussez du contenu, demandez des relectures et répondez aux commentaires.	GitHub
`cr-review`	Examinez les demandes de changement GitBook, résumez les modifications, commentez, approuvez ou demandez des modifications.	GitHub

{% hint style="warning" %} N'oubliez pas de mettre à jour votre dépôt local avec le dernier `fichier SKILL.md` à mesure que GitBook ajoute de nouvelles fonctionnalités. {% endhint %} {% endstep %} {% endstepper %} ## Utiliser les compétences GitBook {% prompt description="Scaffold a Git-synced docs site from a folder of markdown" %} ```markdown En utilisant les compétences GitBook, transformez ce dossier de markdown en un site de documentation GitBook alimenté par Git Sync. 1. Lisez mon dossier de documentation et proposez une structure de site — espaces, arborescence des pages et navigation SUMMARY.md. Montrez-moi avant d'écrire quoi que ce soit. 2. Générez l'ossature du dépôt dans la structure monorepo de GitBook (README.md + SUMMARY.md par espace) et validez-la. 3. Créez le site et les espaces, puis donnez-moi des instructions exactes, à copier-coller, pour l'unique étape que je fais dans l'interface GitBook : relier chaque espace à son dossier avec Git Sync. 4. Une fois que je confirme que la synchronisation est configurée, vérifiez que la structure du site correspond au plan. ``` {% endprompt %} {% prompt description="Upgrade a plain markdown page into a polished GitBook page" %} ```markdown En utilisant les compétences GitBook, réécrivez cette page avec les blocs enrichis de GitBook — elle est actuellement en simple markdown. 1. Lisez la page et dites-moi ce que vous amélioreriez : exemples de code multilingues → onglets, parcours guidés séquentiels → étapes, encadrés → astuces, contenu « choisissez votre parcours » → cartes. 2. Appliquez les changements en utilisant la syntaxe GitBook correcte, y compris le frontmatter (title, description, icon). 3. Gardez mes mots — améliorez la structure, pas le ton. 4. Listez tout ce que je devrais vérifier après son affichage dans GitBook. ``` {% endprompt %} {% prompt description="Generate an API reference from an OpenAPI spec" %} ```markdown En utilisant les compétences GitBook, configurez une section de référence API dans ma documentation à partir de mon spécification OpenAPI. 1. Trouvez ma spécification (ou aidez-moi à en générer une à partir de la base de code si elle n'existe pas) et validez-la. 2. Configurez des pages d'endpoint générées automatiquement avec le bloc OpenAPI de GitBook dans SUMMARY.md — n'écrivez pas les pages d'endpoint à la main ; la spécification reste la source de vérité. 3. Ajoutez une courte page de présentation pour chaque groupe de ressources. 4. Signalez les lacunes de la spécification (descriptions, exemples, schémas de réponse manquants) qui affaibliraient la référence rendue. ``` {% endprompt %} ## FAQ

Que contient SKILL.md ?

`fichier SKILL.md` donne à votre assistant de code IA le contexte dont il a besoin pour créer, modifier et mettre en forme correctement le contenu GitBook. Il inclut : * Une référence complète de la syntaxe pour les blocs personnalisés. * Les formats des fichiers de configuration, notamment `.gitbook.yaml`, `SUMMARY.md`, et `.gitbook/vars.yaml`. * Les options de frontmatter, les contrôles de mise en page, les variables, les expressions, les tableaux de décision et les pièges courants.

Comment tester le contenu généré par l'IA ?

Vérifiez et testez toujours le contenu généré par des assistants IA. Lorsque vous travaillez avec un assistant entraîné sur le fichier de compétences : * Vérifiez que les blocs personnalisés s'affichent correctement dans GitBook. * Vérifiez que tous les liens internes fonctionnent. * Confirmez que le frontmatter est un YAML valide. * Testez que les variables font référence au bon périmètre.

Comment savoir si mon assistant utilise SKILL.md ?

Demandez-lui d'expliquer comment il mettrait en forme une page GitBook. S'il fait référence aux blocs GitBook, au frontmatter, aux variables ou à des fichiers comme `SUMMARY.md`, la compétence est chargée. S'il répond uniquement avec du Markdown générique, vérifiez les règles de votre projet et rechargez l'assistant.

Pourquoi l'assistant ignore-t-il la syntaxe spécifique à GitBook ?

Cela signifie généralement que le fichier de compétences n'est pas chargé, ou que les règles ne sont pas assez précises. Assurez-vous que votre assistant lit `fichier SKILL.md` depuis la racine du dépôt, ou utilise l'URL GitHub dans les instructions de son projet. Si l'assistant met les instructions en cache, redémarrez la session après avoir ajouté ou mis à jour la règle.

Que faire si l'assistant génère un contenu GitBook invalide ?

Vérifiez d'abord les points de défaillance courants : * Blocs personnalisés non fermés * YAML invalide dans le frontmatter * Références de variables cassées * Liens qui ne correspondent pas à la structure de vos pages Vérifiez toujours le résultat dans GitBook avant de le valider.

Ai-je encore besoin d'un jeton d'accès ?

Vous avez besoin d'un jeton d'accès lorsque votre agent interagit directement avec GitBook. Vous pouvez créer un jeton d'accès personnel dans vos [paramètres développeur](https://app.gitbook.com/account/developer). Si vous modifiez uniquement des fichiers localement avec `fichier SKILL.md`, vous n'en aurez peut-être pas besoin tant que vous n'aurez pas connecté l'assistant aux workflows ou aux API GitBook.

Et si la compétence semble obsolète ?

Mettez à jour votre `fichier SKILL.md`local, ou redirigez votre assistant vers la source GitHub. Si votre équipe a copié des parties du fichier dans des règles personnalisées, mettez-les aussi à jour.

--- # 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, and the optional `goal` query parameter: ``` GET https://gitbook.com/docs/documentation/fr/getting-started/ai-documentation/ai-coding-assistants-and-skillmd.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.