Hoe deel je goede prompts met je team?

Kort antwoord

Een gedeeld document vol prompts werkt maar kort: niemand zoekt erin en de beste versie staat bij iemand lokaal. Beter is een goede prompt die vaak terugkomt om te zetten in een skill: een map met een SKILL.md die Claude, ChatGPT, Codex of Cursor zelf oppakt als de taak erom vraagt. In Claude delen eigenaren van een Team- of Enterprise-organisatie skills met iedereen; in Codex staan ze in de repo.

Waarom het gedeelde promptdocument niet werkt

Bijna elk team dat serieus met AI werkt, maakt op een dag een document of Notion-pagina met “onze beste prompts”. Een paar maanden later kijkt niemand er meer in. De prompts zijn verouderd, de beste versie staat in iemands eigen chatgeschiedenis, en wie iets nodig heeft typt het liever opnieuw dan dat hij zoekt. Het probleem is niet de inhoud maar de vorm: een prompt moet je onthouden, opzoeken en plakken.

Van prompt naar skill

Een skill draait dat om. Het is een map met een bestand SKILL.md, met een naam, een beschrijving van wanneer de skill past, en de instructies, eventueel met voorbeelden en scripts erbij. De AI ziet eerst alleen de naam en de beschrijving, en laadt de rest pas als de taak erom vraagt. Het formaat is een open standaard (agentskills.io) die Claude, ChatGPT, Codex en Cursor allemaal lezen.

Gedeeld promptdocument Skill
Hoe je hem gebruikt Zoeken, kopiëren, plakken De AI pakt hem op als de taak past, of je roept hem aan
Waar hij staat Een los document In de AI-tool of in de repository
Bijwerken Iedereen houdt een eigen versie Eén versie, iedereen krijgt de nieuwe
Voorbeelden en sjablonen In de tekst geplakt Als losse bestanden erbij

Hoe je een skill deelt

  1. Claude. Eigenaren van een Team- of Enterprise-organisatie kunnen skills voor alle gebruikers klaarzetten. Gebruikers kunnen een eigen skill delen met specifieke collega’s, op Enterprise ook met groepen, of indienen voor de bibliotheek van de organisatie, waar een eigenaar hem eventueel eerst goedkeurt. Op Team-plannen staat de functie standaard aan.
  2. ChatGPT en Codex. Je maakt een skill met de ingebouwde maker of schrijft het bestand zelf. Codex leest skills uit de repository, in .agents/skills, dus een skill in git is meteen van het hele team. Voor verdere verspreiding wijst OpenAI naar plugins, die skills en koppelingen bundelen.
  3. Cursor. Cursor laadt skills uit de repository, uit .cursor/skills/ en ook uit .agents/skills/ en .claude/skills/. Gebruik .agents/skills/ voor Codex en Cursor. Maak voor Claude Code vanuit .claude/skills/ een symlink naar dezelfde skillmap, of plaats de skill daar ook.

Welke prompts een skill waard zijn

  1. Wat vaker dan eens per week terugkomt. De offerte, het weekverslag, de klantmail na een klacht.
  2. Wat een vaste vorm heeft. Een sjabloon of checklist die steeds hetzelfde moet zijn.
  3. Wat een collega moeilijk kan uitleggen. De werkwijze van de beste verkoper of de ervaren projectleider.

Begin met twee of drie. Een bibliotheek van vijftig skills die niemand bijhoudt, is hetzelfde probleem in een nieuwe vorm.

Het misverstand: de prompt is de waarde

De tekst van een prompt is zelden het geheim. Wat een prompt goed maakt, is de kennis erachter: hoe jullie offertes opbouwen, welke klant wat wil, welke fout vorige keer gemaakt werd. Die kennis verandert. Een skill legt een werkwijze vast, maar niet de klantafspraak van gisteren of de correctie van vanochtend. Dat hoort in de kennis waar de skill uit put. Zie ook Wat zijn agent skills, en werken ze in Claude, ChatGPT, Codex en Cursor?

Wat dit voor een team betekent

Een skill in Claude werkt niet vanzelf in Copilot. Claude Code kan ingeschakelde claude.ai-skills wel automatisch downloaden bij ondersteunde accountaanmelding. Een skill in de repository bereikt ChatGPT niet vanzelf, tenzij iemand hem daar ook installeert. Spreek af waar het origineel staat, wie het bijhoudt, en wanneer iets persoonlijks gedeeld wordt. Daarover gaat Welke afspraken maak je in een team over het werken met AI? en over wat er gebeurt als de maker vertrekt: Wat raak je kwijt als de AI-kampioen van je team vertrekt?

Waar Bombos past

Bombos houdt de kennis bij waar een skill uit put: teamkennis, regels die het team gaandeweg leerde en wat er al in mail, documenten en repo’s ligt. Elke AI-tool van het team, Claude, ChatGPT, Copilot, Grok, Claude Code, Codex, Cursor en eigen agents, leest uit dezelfde bron, en je ziet waarop een antwoord rust. Eén persoon kan het eerst voor zichzelf proberen.

Vragen die hierbij horen

Wat is het verschil tussen een prompt en een skill?

Een prompt typ of plak je zelf. Een skill is een map met instructies, en eventueel voorbeelden en scripts, die de AI uit zichzelf laadt als de taak past bij de beschrijving. Je hoeft hem dus niet te onthouden of op te zoeken.

Kan ik in Claude een skill met het hele team delen?

Ja. Volgens de Help Center kunnen eigenaren van Team- en Enterprise-organisaties skills voor alle gebruikers klaarzetten, kunnen gebruikers skills met specifieke collega's delen als delen is ingeschakeld. Delen met groepen kan alleen op Enterprise. Publiceren naar de bibliotheek van de organisatie vereist dat publiceren is ingeschakeld.

Is een skill van een collega altijd veilig?

Anthropic raadt aan alleen skills uit betrouwbare bron te installeren en bij skills van minder vertrouwde bronnen, ook van collega's, de bestanden en instructies eerst door te lezen. Een skill kan scripts bevatten en verbinding maken met andere diensten.

Bronnen

  1. Using skills in Claude (Claude Help Center)
  2. Build skills (ChatGPT en Codex-documentatie)
  3. Agent Skills
  4. Skills (Cursor-documentatie)
Het eerste half uur · kosteloos

Wat vergeet jullie AI?

  1. 01Je vertelt welke AI jullie gebruiken en waar het steeds opnieuw moet.
  2. 02We laten zien wat een gedeeld geheugen daar verandert, op jullie eigen voorbeelden.
  3. 03Je krijgt het plan mee. Dat houd je, ook zonder Bombos.
Piet Baudoin
Piet BaudoinJe spreekt Piet, van het team van BombosNederlands team uit Utrecht en Nijmegen · data in Europa
We reageren dezelfde werkdag.