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

# Skills

> Créez des packages réutilisables pour les agents externes et les Automations

Les Skills sont des packages réutilisables d'instructions et de fichiers complémentaires facultatifs. Ils permettent à votre équipe de définir une fois une manière reproductible d'accomplir une tâche, puis de l'appliquer de façon cohérente dans Flowglad.

Chaque Skill possède un nom, un slug de commande slash, une description et des instructions rédigées en Markdown. Les fichiers complémentaires peuvent fournir le contexte ou les ressources supplémentaires nécessaires pour suivre ces instructions.

## Utiliser Flowglad comme bibliothèque de Skills de votre équipe

Flowglad conserve chaque Skill sous forme de package versionné. La publication d'une modification crée une nouvelle révision au lieu de remplacer le package précédent. Les administrateurs de l'organisation peuvent ouvrir l'**History** d'un Skill pour inspecter ses révisions, comparer les modifications, restaurer une révision antérieure ou abandonner un brouillon, lorsque ces actions sont disponibles.

Votre équipe dispose ainsi d'un emplacement unique et gouverné pour maintenir des instructions réutilisables, tout en conservant la trace de la version active à un moment donné. Les révisions en brouillon et rejetées ne remplacent pas la version active.

### Gérer les Skills via MCP

Après avoir connecté le serveur MCP de Flowglad, un agent peut inspecter et gérer la bibliothèque de Skills de votre organisation pour vous :

* `skills.list` renvoie les Skills visibles par la connexion.
* `skills.get` renvoie les métadonnées de la dernière révision et de la révision active d'un Skill.
* `skills.create` soumet un nouveau package de Skill.
* `skills.create_candidate` soumet une nouvelle révision d'un Skill existant.
* `skills.publish_revision` vérifie et publie une révision différée.
* `skills.create_package_upload_session` et `skills.finalize_package_upload_session` transportent les packages trop volumineux pour être envoyés en ligne.
* `skills.get` indique le résultat de la vérification et de la promotion de la requête acceptée.

La création ou la mise à jour de Skills nécessite la permission `skills:write` à la fois sur l'adhésion du membre de l'équipe à l'organisation et sur l'autorisation accordée à la connexion MCP. Si vous ajoutez la permission après avoir connecté le serveur, reconnectez Flowglad MCP et autorisez `skills:write` afin que les outils d'écriture deviennent disponibles.

**Permissions :** les administrateurs disposent par défaut d'un accès à la création de Skills. Pour accorder le même accès à un Contributor, ouvrez **Settings** → **Team**, sélectionnez le membre de l'équipe et activez **Skill Authoring**. Cela l'autorise à créer et mettre à jour les Skills de l'organisation sans en faire un administrateur.

## Charger les Skills de Flowglad MCP dans votre agent

Le serveur MCP de Flowglad annonce `io.modelcontextprotocol/skills` lors de l'initialisation MCP. Cela indique aux clients compatibles que le serveur implémente les méthodes de Skills d'agent `skills/list` et `skills/get`. Chaque Skill renvoyé inclut des URI de ressources `skill://` et des empreintes de contenu ; les clients peuvent récupérer les fichiers avec `resources/read`.

La connexion du serveur ne garantit pas qu'un client appellera `skills/list` ou installera les packages renvoyés. La prise en charge varie selon les clients. Ajoutez une instruction de démarrage à ChatGPT / Codex ou Claude si vous souhaitez que l'agent actualise le registre Flowglad au début de chaque session.

**Nommage MCP :** les noms sont volontairement différents. `skills.list`, avec un point, est un outil Flowglad pour les enregistrements de Skills versionnés de votre organisation. `skills/list`, avec une barre oblique, est une méthode d'extension du protocole MCP permettant de découvrir les packages de Skills destinés aux agents.

### Ajouter l'instruction de démarrage

Créez une fois le répertoire de destination avant de démarrer une nouvelle session, puis ajoutez le bloc d'instructions correspondant ci-dessous.

#### ChatGPT / Codex

Créez le répertoire de destination de ChatGPT / Codex avec `mkdir -p ~/.agents/skills`.

Placez le bloc suivant dans `~/.codex/AGENTS.md` pour l'appliquer à tous les projets, ou dans le fichier `AGENTS.md` d'un dépôt pour le partager avec l'équipe de ce dépôt.

```markdown AGENTS.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.agents/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `$skill-name` invocation.
6. If this ChatGPT / Codex client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

#### Claude

Créez le répertoire de destination de Claude avec `mkdir -p ~/.claude/skills`.

Placez le bloc suivant dans `~/.claude/CLAUDE.md` pour l'appliquer à tous les projets, ou dans le fichier `CLAUDE.md` d'un dépôt pour le partager avec l'équipe de ce dépôt.

```markdown CLAUDE.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.claude/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `/skill-name` invocation.
6. If this Claude client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

Vous pouvez demander à ChatGPT / Codex ou à Claude d'ajouter le bloc approprié à son propre fichier d'instructions au niveau utilisateur. Examinez la modification proposée avant de l'accepter, car ce fichier affecte les sessions futures. L'instruction est un bootstrap d'agent appliqué au mieux ; si votre environnement doit actualiser les Skills de manière déterministe, implémentez la même synchronisation dans un hook `SessionStart` de confiance ou dans l'intégration de votre client MCP.

## Où les Skills sont utilisés

Les Skills ont actuellement deux consommateurs :

* Les agents externes compatibles découvrent et synchronisent les packages activés via Flowglad MCP, puis les associent automatiquement ou les invoquent par leur nom.
* Les Automations épinglent une révision publiée exacte d'un Skill en tant que ressource de code OWS `skill-revision`. L'Automation sélectionne un chemin de package et un point d'entrée ; les étapes d'agent ne reçoivent que les Skills autorisés par l'ensemble de capacités scellé de l'exécution.

Le premier chemin fournit des instructions réutilisables à un agent externe. Le second fournit du code immuable et des fichiers complémentaires à une exécution d'Automation reproductible. Les Skills publiés s'appliquent à toute l'organisation : une Automation autorisée peut donc sélectionner la même révision de Skill dans n'importe quel Space. L'Automation consommatrice et ses exécutions restent la propriété de leur Space ; sélectionner un Skill ne modifie pas cette frontière.

## Créer et maintenir des Skills

Ouvrez le **menu de l'organisation** → **Skills** → **New Skill**. Dans l'onglet **Skill**, saisissez un **Name**, un **Slug**, une **Description** facultative et les instructions réutilisables en **Markdown**. Utilisez l'onglet **Files** pour les éventuels fichiers complémentaires du package, puis sélectionnez **Create Skill**.

Le Slug utilise des lettres minuscules, des chiffres et des tirets, commence par une lettre ou un chiffre, et correspond à ce que les utilisateurs saisissent après `/`.

La création ou la modification d'un Skill produit un brouillon. Sur la page de détail du Skill, les modifications sont enregistrées automatiquement ; sélectionnez **Publish Draft** pour vérifier et publier le brouillon. Si la vérification échoue, utilisez les diagnostics affichés pour corriger le brouillon et publiez-le à nouveau.

Utilisez **History** pour inspecter les révisions, restaurer une révision remplacée ou abandonner un brouillon modifiable, lorsque ces actions sont disponibles. **Disable Skill** le retire de la découverte par les agents externes et de la résolution par les Automations sans supprimer l'historique des révisions ; **Enable Skill** le rend de nouveau disponible.

## Créer ou modifier un Skill avec MCP

Utilisez un client MCP externe connecté pour une création centrée sur les packages. Appelez `skills.get` avant de modifier un Skill existant. Utilisez `skills.create` pour un nouveau package ou `skills.create_candidate` pour une révision basée sur la révision active actuelle.

Les petits packages peuvent être fournis en ligne. Pour les packages plus volumineux, appelez `skills.create_package_upload_session`, téléversez les objets demandés et terminez avec `skills.finalize_package_upload_session`. Si la vérification a été différée, appelez `skills.publish_revision`. Interrogez `skills.get` pour suivre la requête de cycle de vie acceptée et le résultat de sa vérification ou de sa promotion.

La publication d'un Skill ne crée, ne révise ni n'active aucune Automation ; utilisez explicitement le cycle de vie MCP des Automations lorsque c'est nécessaire.

## Partir d'un modèle de Skill

La page **Skills** inclut des **Skill Templates**. Recherchez ou filtrez le catalogue, prévisualisez un modèle et sélectionnez **Copy Skill**. La copie devient un Skill de l'organisation qui peut être modifié et publié comme n'importe quel autre Skill.

## Skills et Automations

Un Skill définit comment effectuer un travail réutilisable. Il ne décide pas quand ce travail s'exécute.

Utilisez une Automation lorsqu'un travail doit s'exécuter manuellement, selon une planification ou en réponse à un événement. Une Automation peut épingler une ou plusieurs révisions de Skills afin que la même implémentation soit réutilisée d'une exécution à l'autre.


## Related topics

- [MCP](/docs/fr/mcp-server.md)
- [Automations](/docs/fr/automations.md)
- [Bienvenue](/docs/fr/agents/introduction.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.