Een herbruikbare vaardigheid schrijven
Op deze pagina
Als de instructies van een GPT het hart zijn, dan is de vaardigheid (skill) het hart van een plug-in. Het is het formaat dat u gebruikt om een herbruikbare workflow te schrijven: instructies, bronnen en, indien nodig, scripts. OpenAI-vaardigheden volgen een open standaard genaamd “agent skills” (agentskills.io), wat betekent dat een goed geschreven vaardigheid niet beperkt is tot één enkel hulpmiddel. In deze les leert u hoe u er een schrijft.
De anatomie van een vaardigheid
Een vaardigheid is een map die één verplicht bestand bevat, SKILL.md, en optionele elementen.
synthese-document/
├── SKILL.md ← verplicht: instructies + metadata
├── scripts/ ← optioneel: uitvoerbare code
├── references/ ← optioneel: documentatie
├── assets/ ← optioneel: sjablonen, bronnen
└── agents/
└── openai.yaml ← optioneel: uiterlijk en afhankelijkheden
Het bestand SKILL.md moet een name en een description bevatten. Hier is een minimaal voorbeeld:
---
name: synthese-document
description: Vat een verstrekt document samen in drie delen (overzicht, kernpunten, open vragen). Gebruik dit wanneer de gebruiker vraagt om een samenvatting of rapport van een bijgevoegd document.
---
# Documentsamenvatting
1. Lees het volledige document voordat u begint met schrijven.
2. Schrijf drie secties: Overzicht (3 zinnen), Kernpunten (max. 5 opsommingstekens), Open Vragen.
3. Vertrouw uitsluitend op het document; als informatie ontbreekt, schrijf dan "niet verstrekt".
4. Gebruik het sjabloon in `assets/modele.md` voor de opmaak.
De beschrijving is het kernpunt
ChatGPT en Codex activeren een vaardigheid op twee manieren. Of u roept deze expliciet aan—door @ te typen in ChatGPT, of /skills en $ in Codex—of het hulpmiddel selecteert deze automatisch wanneer uw verzoek overeenkomt met de beschrijving. Daarom legt de documentatie de nadruk op dit veld: u heeft een beknopte beschrijving nodig die begint met de primaire use-case en trefwoorden, en die duidelijk de grenzen aangeeft.
Een specifiek mechanisme stuurt deze eis aan: progressieve onthulling (progressive disclosure). Initially lezen ChatGPT en Codex alleen de naam en beschrijving van elke geïnstalleerde vaardigheid; ze laden de volledige instructies uit SKILL.md pas wanneer ze de vaardigheid daadwerkelijk gebruiken. Hierdoor kunt u veel vaardigheden installeren zonder de context te verstoppen, maar het betekent ook dat een vaag beschrijving leidt tot een vaardigheid die ofwel nooit op het juiste moment wordt gekozen, ofwel op het verkeerde moment.
Optionele instellingen
Met het bestand agents/openai.yaml kunt u de weergave in de desktop-app verfijnen (naam, korte beschrijving, pictogrammen, kleur, standaardprompt), hulpmiddelen declareren waarvan de vaardigheid afhankelijk is—bijvoorbeeld een MCP-server—en een aanroepbeleid instellen. Het instellen van allow_implicit_invocation: false verhindert dat ChatGPT de vaardigheid zelfstandig kiest: handig voor gevoelige workflows die u alleen op aanvraag wilt activeren.
Waar vaardigheden leven en hoe u ze deelt
Een zelfstandige vaardigheid werkt in de ChatGPT-desktop-app, in Codex via de commandoregel en in de editor-extensie; in Codex komen projectvaardigheden in de map .agents/skills van de repository. Om een vaardigheid beschikbaar te stellen voor anderen, raadt OpenAI aan deze te verpakken in een plug-in: een plug-in kan meerdere vaardigheden bundelen en verbindingen toevoegen aan MCP-servers of presentatie-elementen. Vaardigheden die in een plug-in zijn opgenomen, worden vervolgens beschikbaar in de chat- en werkmodi in ChatGPT, op het web, op de desktop en op mobiel. In ChatGPT op het web kunt u via het tabblad Vaardigheden (Skills) in de plug-in-map ook een vaardigheid maken via conversatie (met de ingebouwde skill-creator-vaardigheid), met een editor of door import, en deze delen binnen uw werkruimte; dit tabblad is voorbehouden aan in aanmerking komende Business-, Enterprise-, Healthcare- en Edu-abonnementen.
Aan de slag
Van GPT naar vaardigheid. Neem de instructies over van de GPT die u hebt gebouwd in les 4 tot en met 7. Transformeer deze tot een SKILL.md: een korte naam, een beschrijving die aangeeft wanneer u deze wel en niet moet gebruiken, genummerde stappen, en uw kennisbestanden opgeslagen in references/. Test de vaardigheid vervolgens twee keer: één keer door deze aan te roepen met @, en één keer met een gewoon verzoek dat deze zou moeten activeren.
Officiële bronnen: Build skills (ChatGPT-documentatie: SKILL.md, beschrijving, locaties) · Skills in ChatGPT (OpenAI Help Center: tabblad Vaardigheden, abonnementen, delen)
Belangrijkste punten
- Een vaardigheid is een map met een
SKILL.md(verplichte naam + beschrijving) en optionele bronnen; deze volgt de open standaard voor agent-vaardigheden - De beschrijving bepaalt wanneer de vaardigheid wordt gekozen: begin met de use-case, trefwoorden en grenzen
- Progressieve onthulling: alleen de naam en beschrijving worden eerst gelezen; instructies worden geladen op het moment van gebruik
- Om een vaardigheid te delen, verpakt u deze in een plug-in
Test uw kennis
Van GPT’s naar plug-ins: valideer de volledige reis.
1. Aangepaste instructies, Geheugen, GPT: wat is het verschil?
Antwoord: Aangepaste instructies kleuren al uw gesprekken; Geheugen onthoudt feiten over u in de loop van de tijd; een GPT is een verpakte assistent—instructies, kennis, hulpmiddelen—die met anderen kan worden gedeeld.
2. Wat bevat een goede systeem-instructie voor een GPT?
Antwoord: De rol, reikwijdte (wat het wel en niet doet), toon, responsformaat en afhandeling van randgevallen—geschreven als een functiebeschrijving, niet als een wensenlijstje.
3. Waar dient de kennisbank voor?
Antwoord: Om de GPT te voorzien van referentiedocumenten die deze raadpleegt om antwoorden te geven—uw gidsen, catalogi of procedures—in plaats van uitsluitend te vertrouwen op het trainingsgeheugen.
4. Wat gebeurt er met de acties van een GPT bij migratie naar een plug-in?
Antwoord: Deze worden niet overgedragen: u moet controleren of er al een app bestaat in de plug-in-map, anders moet u de integratie opnieuw opbouwen, bijvoorbeeld met een MCP-server. De instructies worden een vaardigheid en de kennisbank wordt referentiebestanden.
5. Wat controleert u voordat u een GPT of plug-in deelt?
Antwoord: Tests op reële gevallen en randgevallen, naleving van het gebruiksbeleid, duidelijkheid van de beschrijving, een privacybeleid voor elke openbare actie, en dat er geen gevoelige gegevens verborgen zitten in de instructies of bestanden.
Een gedeeld hulpmiddel legt de maker verplichtingen op: test alsof uw gebruikers er al zijn, en migreer uw GPT’s vóór 11 december 2026.