> ## 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

> Maak herbruikbare pakketten voor externe agents en Automations

Skills zijn herbruikbare pakketten met instructies en optionele ondersteunende bestanden. Hiermee kan je team één keer een herhaalbare manier vastleggen om een taak uit te voeren en die vervolgens consistent toepassen in heel Flowglad.

Elke Skill heeft een naam, een slug voor het slash-commando, een beschrijving en instructies die in Markdown zijn geschreven. Ondersteunende bestanden kunnen aanvullende context of resources bieden die nodig zijn om die instructies te volgen.

## Gebruik Flowglad als de Skill-bibliotheek van je team

Flowglad bewaart elke Skill als een pakket met versiebeheer. Het publiceren van een wijziging maakt een nieuwe revisie aan in plaats van het vorige pakket ter plekke te vervangen. Organisatiebeheerders kunnen de **History** van een Skill openen om de revisies te bekijken, wijzigingen te vergelijken, een eerdere revisie te herstellen of een concept te verwijderen wanneer die acties beschikbaar zijn.

Zo heeft je team één beheerde plek om herbruikbare instructies te onderhouden, terwijl behouden blijft welke versie op een bepaald moment actief was. Concepten en afgewezen revisies vervangen de actieve versie niet.

### Skills beheren via MCP

Nadat je de Flowglad MCP-server hebt verbonden, kan een agent de Skill-bibliotheek van je organisatie voor je bekijken en beheren:

* `skills.list` retourneert de Skills die zichtbaar zijn voor de verbinding.
* `skills.get` retourneert de metadata van de nieuwste en de actieve revisie van één Skill.
* `skills.create` dient een nieuw Skill-pakket in.
* `skills.create_candidate` dient een nieuwe revisie van een bestaande Skill in.
* `skills.publish_revision` verifieert en publiceert een uitgestelde revisie.
* `skills.create_package_upload_session` en `skills.finalize_package_upload_session` transporteren pakketten die te groot zijn om inline te verzenden.
* `skills.get` rapporteert het verificatie- en promotieresultaat van het geaccepteerde verzoek.

Voor het aanmaken of bijwerken van Skills is het recht `skills:write` vereist op zowel het organisatielidmaatschap van de teamgenoot als de grant van de MCP-verbinding. Als je het recht toevoegt nadat je de server hebt verbonden, verbind Flowglad MCP dan opnieuw en autoriseer `skills:write`, zodat de schrijftools beschikbaar worden.

**Rechten:** Admins hebben standaard toegang tot het schrijven van Skills. Om een Contributor dezelfde toegang te geven, open je **Settings** → **Team**, selecteer je de teamgenoot en schakel je **Skill Authoring** in. Dit geeft toestemming om Skills van de organisatie aan te maken en bij te werken zonder de teamgenoot admin te maken.

## Flowglad MCP-Skills in je agent laden

De Flowglad MCP-server adverteert `io.modelcontextprotocol/skills` tijdens de MCP-initialisatie. Dit vertelt compatibele clients dat de server de agent-Skill-methoden `skills/list` en `skills/get` implementeert. Elke geretourneerde Skill bevat `skill://`-resource-URI's en content-digests; clients kunnen de bestanden ophalen met `resources/read`.

Het verbinden van de server garandeert niet dat een client `skills/list` aanroept of de geretourneerde pakketten installeert. Ondersteuning verschilt per client. Voeg een opstartinstructie toe aan ChatGPT / Codex of Claude wanneer je wilt dat de agent het Flowglad-register aan het begin van elke sessie vernieuwt.

**MCP-naamgeving:** De namen verschillen bewust. `skills.list` met een punt is een Flowglad-tool voor de Skill-records met versiebeheer van je organisatie. `skills/list` met een schuine streep is een methode van een MCP-protocolextensie voor het ontdekken van Skill-pakketten voor agents.

### De opstartinstructie toevoegen

Maak de doelmap één keer aan voordat je een nieuwe sessie start en voeg daarna het bijbehorende instructieblok hieronder toe.

#### ChatGPT / Codex

Maak de doelmap voor ChatGPT / Codex aan met `mkdir -p ~/.agents/skills`.

Plaats het volgende blok in `~/.codex/AGENTS.md` om het op elk project toe te passen, of in de `AGENTS.md` van een repository om het te delen met het team van die repository.

```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

Maak de doelmap voor Claude aan met `mkdir -p ~/.claude/skills`.

Plaats het volgende blok in `~/.claude/CLAUDE.md` om het op elk project toe te passen, of in de `CLAUDE.md` van een repository om het te delen met het team van die repository.

```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.
```

Je kunt ChatGPT / Codex of Claude vragen om het juiste blok toe te voegen aan hun eigen instructiebestand op gebruikersniveau. Controleer de voorgestelde wijziging voordat je die accepteert, omdat dat bestand toekomstige sessies beïnvloedt. De instructie is een best-effort bootstrap voor de agent; als je omgeving Skills deterministisch moet vernieuwen, implementeer dan dezelfde synchronisatie in een vertrouwde `SessionStart`-hook of in de integratie van je MCP-client.

## Waar Skills worden gebruikt

Skills hebben momenteel twee afnemers:

* Compatibele externe agents ontdekken en synchroniseren ingeschakelde pakketten via Flowglad MCP en matchen ze vervolgens automatisch of roepen ze op naam aan.
* Automations pinnen een exacte gepubliceerde Skill-revisie als een OWS-coderesource van het type `skill-revision`. De Automation selecteert een pakketpad en entrypoint; agent-steps ontvangen alleen de Skills die zijn geautoriseerd door de verzegelde set run-capabilities.

Het eerste pad levert herbruikbare instructies aan een externe agent. Het tweede levert onveranderlijke code en ondersteunende bestanden aan een herhaalbare Automation-run. Gepubliceerde Skills gelden voor de hele organisatie, zodat een geautoriseerde Automation dezelfde Skill-revisie in elke Space kan selecteren. De afnemende Automation en de runs ervan blijven eigendom van hun Space; het selecteren van een Skill verandert die grens niet.

## Skills aanmaken en onderhouden

Open het **organisatiemenu** → **Skills** → **New Skill**. Voer op het tabblad **Skill** de **Name**, **Slug**, een optionele **Description** en de herbruikbare instructies in **Markdown** in. Gebruik het tabblad **Files** voor eventuele ondersteunende pakketbestanden en selecteer daarna **Create Skill**.

De Slug gebruikt kleine letters, cijfers en koppeltekens, begint met een letter of cijfer, en is wat gebruikers na `/` typen.

Het aanmaken of bewerken van een Skill levert een concept op. Op de detailpagina van de Skill worden bewerkingen automatisch opgeslagen; selecteer **Publish Draft** om het concept te verifiëren en te publiceren. Als de verificatie mislukt, gebruik dan de getoonde diagnostiek om het concept te corrigeren en publiceer opnieuw.

Gebruik **History** om revisies te bekijken, een vervangen revisie te herstellen of een bewerkbaar concept te verwijderen wanneer die acties beschikbaar zijn. **Disable Skill** verwijdert de Skill uit de ontdekking door externe agents en uit de resolutie door Automations zonder de revisiegeschiedenis te verwijderen; **Enable Skill** maakt de Skill weer beschikbaar.

## Een Skill aanmaken of bewerken met MCP

Gebruik een verbonden externe MCP-client voor authoring waarbij het pakket centraal staat. Roep `skills.get` aan voordat je een bestaande Skill bewerkt. Gebruik `skills.create` voor een nieuw pakket of `skills.create_candidate` voor een revisie op basis van de huidige actieve revisie.

Kleine pakketten kunnen inline worden aangeleverd. Roep voor grotere pakketten `skills.create_package_upload_session` aan, upload de gevraagde objecten en rond af met `skills.finalize_package_upload_session`. Als de verificatie is uitgesteld, roep dan `skills.publish_revision` aan. Poll `skills.get` voor het geaccepteerde lifecycleverzoek en het bijbehorende verificatie- of promotieresultaat.

Het publiceren van een Skill maakt geen Automation aan, herziet die niet en activeert die niet; gebruik de Automation-MCP-lifecycle expliciet wanneer dat nodig is.

## Beginnen vanuit een Skill-template

De pagina **Skills** bevat **Skill Templates**. Doorzoek of filter de catalogus, bekijk een voorbeeld van een template en selecteer **Copy Skill**. De kopie wordt een Skill van de organisatie die net als elke andere Skill kan worden bewerkt en gepubliceerd.

## Skills en Automations

Een Skill definieert hoe herbruikbaar werk moet worden uitgevoerd. Een Skill bepaalt niet wanneer dat werk wordt uitgevoerd.

Gebruik een Automation wanneer werk handmatig, volgens een schema of als reactie op een event moet worden uitgevoerd. Een Automation kan een of meer Skill-revisies pinnen, zodat dezelfde implementatie over meerdere runs wordt hergebruikt.


## Related topics

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


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