> ## 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 paquets réutilisables pour les agents externes et les Automations

Les Skills sont des paquets réutilisables d'instructions et de fichiers complémentaires facultatifs. Ils permettent à votre équipe de définir une seule fois une façon reproductible d'accomplir une tâche, puis de l'appliquer uniformément dans Flowglad.

Chaque Skill comporte un nom, un slug de commande à barre oblique, 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 paquet versionné. La publication d'une modification crée une nouvelle révision au lieu de remplacer le paquet précédent sur place. Les administrateurs de l'organisation peuvent ouvrir l'**History** d'un Skill pour consulter ses révisions, comparer les modifications, restaurer une révision antérieure ou abandonner un brouillon lorsque ces actions sont offertes.

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

### Gérer les Skills au moyen de MCP

Une fois le serveur MCP de Flowglad connecté, un agent peut consulter et gérer la bibliothèque de Skills de votre organisation pour vous :

* `skills.list` renvoie les Skills visibles pour 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 paquet 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 paquets 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 exige la permission `skills:write` à la fois sur l'adhésion du coéquipier à 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` pour que les outils d'écriture deviennent disponibles.

**Permissions :** Les administrateurs ont accès par défaut à la rédaction de Skills. Pour accorder le même accès à un Contributor, ouvrez **Settings** → **Team**, sélectionnez le coéquipier et activez **Skill Authoring**. Cela accorde la permission de créer et de mettre à jour les Skills de l'organisation sans faire du coéquipier un administrateur.

## Charger les Skills MCP de Flowglad 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 Skill d'agent `skills/list` et `skills/get`. Chaque Skill renvoyé comprend des URI de ressources `skill://` et des empreintes de contenu; les clients peuvent récupérer les fichiers avec `resources/read`.

Le fait de connecter le serveur ne garantit pas qu'un client appellera `skills/list` ou installera les paquets renvoyés. La prise en charge varie selon le client. Ajoutez une instruction de démarrage à ChatGPT / Codex ou à Claude si vous voulez 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 servant à découvrir les paquets 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 de niveau utilisateur. Examinez la modification proposée avant de l'accepter, car ce fichier influe sur les sessions futures. L'instruction constitue une amorce d'agent au mieux; si votre environnement doit actualiser les Skills de façon 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 paquets activés au moyen de Flowglad MCP, puis les sélectionnent automatiquement ou les invoquent par leur nom.
* Les Automations épinglent une révision de Skill publiée précise en tant que ressource de code OWS `skill-revision`. L'Automation sélectionne un chemin de paquet et un point d'entrée; les étapes d'agent ne reçoivent que les Skills autorisés par l'ensemble scellé de capacités 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 demeurent la propriété de leur Space; la sélection d'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 le **Name**, le **Slug**, une **Description** facultative et les instructions réutilisables en **Markdown**. Utilisez l'onglet **Files** pour tout fichier complémentaire du paquet, puis sélectionnez **Create Skill**.

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

La création ou la modification d'un Skill produit un brouillon. Sur la page de détails 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, puis publiez-le de nouveau.

Utilisez **History** pour consulter les révisions, restaurer une révision remplacée ou abandonner un brouillon modifiable lorsque ces actions sont offertes. **Disable Skill** retire le Skill 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 rédaction axée sur les paquets. Appelez `skills.get` avant de modifier un Skill existant. Utilisez `skills.create` pour un nouveau paquet ou `skills.create_candidate` pour une révision fondée sur la révision active actuelle.

Les petits paquets peuvent être fournis en ligne. Pour les paquets plus volumineux, appelez `skills.create_package_upload_session`, téléversez les objets demandés, puis 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 vous en avez besoin.

## Partir d'un modèle de Skill

La page **Skills** comprend les **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 accomplir un travail réutilisable. Il ne décide pas du moment où ce travail s'exécute.

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


## Related topics

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


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