Skills aanmaken en beheren

Skills worden nuttiger wanneer een heel team ze deelt. Notion geeft je team één gedeelde Skills-bibliotheek die elke agent kan gebruiken.

• Werkt voor het hele team. Iedereen kan een Skill schrijven in de Notion-editor, zonder dat markdown vereist is. Teamgenoten kunnen opmerkingen en voorgestelde bewerkingen achterlaten, en een Skill kan linken naar elke pagina in je workspace.

• Werkt met elke agent. Koppel een agent één keer aan Notion en de agent laadt je Skills live. Je kunt Skills ook synchroniseren met GitHub of downloaden naar lokale agents.

• Ingebouwde beheeropties. Skills zijn pagina's, dus paginamachtigingen en versiegeschiedenis zijn van toepassing. Beheerders kunnen Skills installeren voor iedereen in de workspace, en analyses laten zien hoe vaak elke Skill wordt gebruikt.

Skills zijn een van de weinige manieren om met AI in Notion te werken. Hier is hoe ze zich tot elkaar verhouden:

Gebruik een Skill wanneer je taak:

• Herhaalbaar: je of je team doet dit vaak.

• Contextueel: Het moet nu op een specifieke selectie of pagina worden uitgevoerd.

• Consistent: Je wilt elke keer dezelfde structuur of kwaliteit.

Een goede vuistregel: als je dezelfde prompt twee keer zou kopiëren en plakken, is die waarschijnlijk een goede kandidaat voor een Skill.

• Herschrijven voor directieniveau (toon, lengte, indeling).

• Notulen van vergaderingen omzetten in actie-items of een samenvattende e-mail.

• Concepten omzetten naar een specifiek sjabloon (FAQ, PRD-samenvatting, specificatie-opzet).

• Opmaak standaardiseren in documenten (opsommingstekens, koppen, stijl).

1. Ga naar Bibliotheek in je zijbalk en open het tabblad Skills.

2. Selecteer Nieuwe Skill.

3. Notion maakt een nieuwe privé-Skill-pagina aan en opent die. Schrijf je instructies en voeg vervolgens een Beschrijving toe waarin staat wat de Skill doet en wanneer je die gebruikt.

Je Bibliotheek kan meerdere tabbladen hebben, dus het tabblad Skills is misschien niet het eerste dat je ziet. Je kunt er ook komen vanuit de chat met Notion-agent door / te typen om je Skills te zien. Selecteer vervolgens Alle Skills in Bibliotheek bekijken.

Elke Skill-pagina heeft een Beschrijving-veld en een Bestanden-veld. Gebruik Bestanden voor ondersteunend materiaal zoals voorbeelden, sjablonen of scripts.

Selecteer ••• bovenaan een willekeurige pagina, selecteer Gebruiken met AI en selecteer vervolgens Gebruiken als AI-Skill.

Je kunt Notion-agent ook vragen om een pagina voor je als Skill te markeren.

Skill-pagina's tonen bovenaan skill-bedieningselementen, zoals de Ingeschakeld-schakelaar en Uitvoeren, zodat je ze kunt onderscheiden van gewone pagina's.

Als je al Skills hebt opgeslagen als SKILL.md-bestanden, kun je ze in Notion importeren:

• Een Skill uploaden: Selecteer in Bibliotheek → Skills de optie Meer manieren om een Skill toe te voegen → Skill uploaden. Je kunt een .md- of .zip-bestand uploaden.

• Je agent vragen: Wanneer je een agent koppelt, biedt die aan om de Skills op je computer naar Notion te uploaden. Je kunt de agent ook later vragen om een map met Skills te uploaden.

• Een database met handleidingen omzetten in Skills: Ontdek hoe je een bestaande database omzet in een Skill-database →

Als je een Skill inschakelt, kun je die gebruiken in Notion-agent en in je gekoppelde agents. Schakel je de Skill uit, dan is die op beide plekken niet meer beschikbaar.

1. Ga naar Bibliotheek → Skills.

2. Zet de schakelaar in de kolom Voor mij inschakelen naast de Skill aan.

Wil je een Skill wel in Notion-agent gebruiken, maar niet in je gekoppelde agents? Open dan het instellingenmenu via het pictogram met schuifregelaars naast de Skill of bovenaan de Skill-pagina. Ga onder Andere agents met de muisaanwijzer over Gebruiken in gekoppelde agents en kies Uitgeschakeld.

Je keuzes zijn persoonlijk. Ze veranderen niet wat andere leden zien.

Je kunt skills automatisch uitvoeren of vanuit de editor door tekst te markeren, over een blok te zweven of / naast content te typen.

Typ in chat met Notion Agent / om een menu te zien van alle skills die je hebt toegevoegd, of typ / gevolgd door de naam van de skill om er direct een uit te voeren.

Notion Agent kan je Skills gebruiken zonder dat je ze bij naam noemt. Beschrijf wat je nodig hebt, en als een Skill goed past, kan Notion Agent deze automatisch gebruiken. Zo werkt het:

• Automatisch gebruik staat standaard aan, dus Notion Agent kan een Skill gaan gebruiken zodra deze klaar is.

  • Als je wilt dat een Skill alleen wordt uitgevoerd wanneer je erom vraagt, open je het instellingenmenu van de Skill. Stel onder Notion AgentAutomatisch gebruiken in op Uitgeschakeld.

• Een Skill heeft een beschrijving nodig om automatisch te kunnen worden uitgevoerd. Voeg er een toe in het veld Beschrijving bovenaan de Skill-pagina, of in de eigenschap Beschrijving als de Skill in een Skill-database staat.

• Notion Agent leest de beschrijving om te bepalen of de Skill een goede match is, dus houd deze duidelijk en specifiek.

Selecteer een tekstgedeelte en kies vervolgens een Skill uit het tekstselectiemenu.

Alleen Skills die je op een pagina laat weergeven, verschijnen in deze menu's. Wil je dit wijzigen? Open het instellingenmenu van de Skill op het tabblad Skills in je Bibliotheek en selecteer Skill weergeven. Je eigen Skills verschijnen eerst, gevolgd door de ingebouwde standaard-Skills: Schrijven verbeteren, Controleren op fouten, Uitleggen en Opnieuw opmaken.

In het slash-menu:

• Typ /skill naast content om door je beschikbare Skills te bladeren. Het slash-menu toont alleen Skills wanneer er content op de regel staat, omdat een Skill iets nodig heeft om op uit te voeren.

• In chat met Notion Agent kun je ook / gevolgd door de naam van de Skill typen om direct naar een specifieke Skill te gaan. Deze snelkoppeling werkt niet op een pagina tenzij er content naast staat.

In het blokmenu:

• Klik op het ⁚⁚-pictogram dat verschijnt wanneer je over een blok zweeft om het blokmenu te openen.

• Selecteer Skills.

• Kies een Skill om deze op dat blok uit te voeren.

Skills zijn beschikbaar in tekst, koppen (H1, H2, H3), citaten, markeringen, lijsten met opsommingstekens, genummerde lijsten, to-do's, toggles, afbeeldingen en gesynchroniseerde blokken. Skills verschijnen niet in lege blokken of bloktypen die niet in deze lijst staan. Als je een Skill toepast op een blok met geneste inhoud, dan bevat de Skill ook die geneste inhoud.

Notion kan Skills voorstellen in je AI-notulen, zodat je met één klik actie kunt ondernemen op basis van een vergadering.

1. Open notulen van een vergadering die nog wordt getranscribeerd, of notulen met een voltooide samenvatting.

2. Je ziet voorgestelde Skills in de notulen. Je kunt ze ook bekijken door Notion-agent te openen via het gezichtspictogram onderaan in de hoek van de notulen.

3. Selecteer een voorgestelde Skill om die uit te voeren, bijvoorbeeld om tijdens de vergadering beslissingen samen te vatten of na afloop vervolgtaken aan te maken. Je kunt hier ook een nieuwe Skill maken.

Tijdens de vergadering krijg je andere suggesties te zien dan erna. Wil je kiezen welke Skills in de notulen verschijnen? Ga dan naar Bibliotheek → Skills, open het instellingenmenu van de Skill, selecteer Skill weergeven en schakel Tijdens vergaderingen, Na vergaderingen, of beide in. Elke lijst bevat maximaal 12 Skills.

Leer meer over AI-notulen →

Er zijn drie manieren om je Notion-Skills buiten Notion te gebruiken. Bij alle drie blijft Notion de plek waar je Skills schrijft en onderhoudt.

Agents die via MCP aan Notion zijn gekoppeld, kunnen aan het begin van elke sessie je Skills uit Notion laden en de juiste kiezen voor de taak. Als je een Skill in Notion bewerkt, krijgt elke gekoppelde agent de update. Je hebt eerst een werkende Notion MCP-verbinding nodig.

1. Open Bibliotheek → Skills.

2. Selecteer Instellen in de banner met de tekst Je Skills gebruiken met gekoppelde agents?

3. Selecteer Kopiëren om de instellingsprompt te kopiëren.

4. Plak de prompt in een nieuwe chat met je agent en volg de aanwijzingen. De agent voegt een regel toe aan de instructies om je Skills bij elke sessie te laden en biedt aan om Skills te uploaden die al op je computer staan.

Stel elke agent-app afzonderlijk in. Als je Claude en Cursor gebruikt, voer de instellingsprompt dan in beide uit.

GitHub-synchronisatie kopieert elk uur je Skills uit Notion naar een GitHub-repository. Je beheerder kan die repository vervolgens toevoegen als pluginmarktplaats in Claude of ChatGPTcodex, zodat de Skills voor iedereen in die apps verschijnen. Ga aan de slag met het opensourceproject Notion skills GitHub sync.

Stuur een kopie van een Skill naar een lokale agent zoals Claude Code, Codex, Cursor, Gemini of Grok Build. Dit werkt in de Notion-desktopapp als je workspace toestaat dat je Skills lokaal downloadt.

1. Open de Skill-pagina in de Notion-desktopapp.

2. Open bovenaan de pagina het instellingenmenu van de Skill via het pictogram met de schuifregelaars.

3. Selecteer onder Andere agents de optie Downloaden voor lokale agents en kies vervolgens waar je de Skill naartoe wilt sturen.

Notion slaat de Skill op als een SKILL.md-bestand en vraagt om toestemming voordat bijgevoegde bestanden worden geïnstalleerd. Als de Skill in Notion verandert, wordt de gedownloade kopie als verouderd gemarkeerd. Zo weet je dat je de Skill opnieuw moet downloaden.

Ontwikkelaars kunnen Skills ook weergeven, downloaden en uploaden met de Agent Skills API. Zie de documentatie voor ontwikkelaars →

Een Skills-database geeft je team één plek om samen Skills aan te maken en te beheren. Elke pagina die je erin aanmaakt, wordt automatisch een Skill en elke Skill krijgt een beschrijvingseigenschap. Notion Agent leest die beschrijving om te bepalen wanneer de Skill zelfstandig moet worden gebruikt.

Een Skill-database werkt als elke andere Notion database, met een paar eigenschappen die al voor je zijn ingesteld:

• Beschrijving zegt wat de Skill doet en wanneer je deze moet gebruiken. Notion-agent leest dit om te bepalen wanneer de Skill past.

• Bestanden bevat ondersteunend materiaal, zoals voorbeelden, referentiedocumenten, afbeeldingen, databestanden of scripts.

Je kunt alle andere eigenschappen toevoegen die voor je team belangrijk zijn, zoals Eigenaar om te laten zien wie een Skill actueel houdt, of Status om te laten zien welke Skills klaar zijn voor gebruik.

Begin met één gedeelde Skill-database

Eén Skill-database werkt goed wanneer dezelfde groep de Skills gebruikt en dezelfde mensen ze up-to-date houden, omdat iedereen weet waar ze als eerste moeten kijken. Voeg een andere Teamdatabase toe, of een Privédatabase, wanneer een groep andere toegang, andere eigenaren nodig heeft, of een plek om aan een Skill te werken voordat deze wordt gedeeld.

Database versus bibliotheek

De Skills-bibliotheek is geen database. Het is een weergave die alle Skills waartoe je toegang hebt uit alle databases in je workspace samenbrengt.

• Maak een nieuwe pagina aan, selecteer Database en kies vervolgens Skills (of Database - Inline → Skills).

• Of selecteer + naast de naam van een Teamspace en kies dezelfde optie.

Het maken ervan in een Teamspace betekent dat je team er direct bij kan, dus je hoeft het later niet te verplaatsen of de toegang te wijzigen.

1. Open de database.

2. Open de instellingen (schuifregelaar-pictogram) in de werkbalk van de weergave.

3. Selecteer Meer instellingen → Veranderen in in het instellingenpaneel.

4. Selecteer Veranderen in Skills-database.

5. Je ziet een instellingsvenster. Kies welke bestaande eigenschappen je wilt koppelen aan Beschrijving, Bestanden en Tags, of behoud de standaardwaarden om nieuwe te maken. Wil je de bestaande pagina's meteen als Skills voor jezelf inschakelen? Vink dan Skills voor mij inschakelen aan. Bij dit vakje staat het aantal pagina's.

Vanaf dat moment wordt elke pagina die in de database wordt gemaakt een Skill. Dit werkt het beste wanneer de pagina's in de database al uitleggen hoe een taak moet worden uitgevoerd, zoals een set playbooks of handleidingen.

Als je al een pagina hebt die uitlegt hoe je een herhaalbare taak uitvoert, verplaats deze dan naar een Skill-database. De pagina wordt een Skill en neemt de Skill-eigenschappen over, inclusief Beschrijving.

1. Open de pagina en selecteer ••• en selecteer vervolgens Verplaatsen naar.

2. Kies je Skill-database.

3. Voeg een duidelijke Beschrijving toe zodat Notion-agent weet wanneer deze gebruikt moet worden.

Een Skill bewerken

Je kunt een Skill bewerken vanuit het tekstselectiemenu of het blokmenu.

Wil je de inhoud van een Skill bewerken via het tekstselectiemenu? Houd de muisaanwijzer boven de naam en selecteer het potloodpictogram. Je kunt de pagina van een Skill ook openen vanuit je Bibliotheek of de Skills-database om deze te bewerken.

Skills beheren vanuit je Bibliotheek

1. Ga naar Bibliotheek in je zijbalk en open het tabblad Skills.

2. Vanaf daar kun je je bestaande Skills bekijken, nieuwe Skills toevoegen en elke Skill-pagina openen om deze te bewerken.

3. Kies waar een Skill verschijnt: open het instellingenmenu en selecteer Skill tonen. Kies Op een pagina voor de teksteditor, het slashmenu en het blokmenu, In chat voor de chat met de Notion-agent en Tijdens vergaderingen of Na vergaderingen voor notulen.

Skills beheren vanuit je teksteditor

Markeer tekst en selecteer vervolgens Manage Skills naast je skills in het menu.

• Het Discover-tabblad van de Bibliotheek toont Skill-pagina's die anderen met je hebben gedeeld, zodat je kunt bladeren door wat je team heeft gebouwd.

• Een Skill gevonden die je wilt gebruiken? Zet de schakelaar in de kolom Voor mij inschakelen aan om de Skill aan je eigen Skills toe te voegen.

Omdat skills pagina's zijn, werkt delen op dezelfde manier als voor elke andere pagina in Notion.

• Als je een skill met iemand deelt, kan diegene de skill uitvoeren zodra diegene toegang heeft tot de skill-pagina.

• Als diegene de skill-pagina kan bewerken, zullen hun bewerkingen de skill wijzigen.

• Bekijk skills die je hebt gemaakt, skills die met je zijn gedeeld en skills in je werkruimte door naar Library in je zijbalk te gaan en het Skills-tabblad te openen.

• Gedeelde skill-pagina's gedragen zich als gewone pagina's, dus ze verschijnen ook onder Shared in je Bibliotheek.

• Deel één Skill-pagina wanneer slechts enkele mensen die ene workflow nodig hebben. Deel de hele Skill-database wanneer je team elke Skill daarin moet krijgen.

• Iedereen met bewerkingsrechten kan een gedeelde Skill wijzigen voor iedereen die deze gebruikt, dus kies bewerkers met dat in gedachten. Paginageschiedenis laat zien wat er is gewijzigd als je terug moet gaan.

• Gekoppelde agents zien alleen de Skills waartoe je toegang hebt in Notion.

Toegang hebben tot een Skill en die inschakelen zijn twee verschillende dingen. Toegang bepaalt wie een Skill kan openen of bewerken. Inschakelen bepaalt of de Skill in je eigen Skills-menu verschijnt. Skills die met je zijn gedeeld, verschijnen op het tabblad Ontdekken van je Bibliotheek. Daar kun je ze inschakelen in de kolom Voor mij inschakelen.

Analyses van Skills laten zien hoe vaak een Skill wordt gebruikt, in Notion en in andere agents.

• In je Bibliotheek: De kolom Gebruik in Bibliotheek → Skills laat zien hoe vaak mensen in je workspace elke Skill in de afgelopen 28 dagen hebben gebruikt, ook via MCP in gekoppelde agents.

• Voor één Skill: Open het instellingenmenu van de Skill en selecteer Analyses bekijken om te zien hoe het gebruik in de loop van de tijd is veranderd.

Het kan enkele uren duren voordat nieuw gebruik zichtbaar is.

Workspace-eigenaren kunnen Skills kiezen om voor iedereen te installeren, zodat het hele team met dezelfde set begint. Ga naar Instellingen → Notion AI → Algemeen en zoek Standaard-Skills voor de workspace in het gedeelte Skills.

1. Kies voor wie de Skills zijn: iedereen in de workspace of een specifieke groep.

2. Selecteer Skill toevoegen en kies de Skills die je wilt installeren.

3. Kies voor elke Skill waar die verschijnt, zoals in de chat of op een pagina.

Standaard-Skills worden automatisch voor leden geïnstalleerd, ook in hun gekoppelde agents. Leden kunnen een standaard-Skill nog steeds voor zichzelf uitschakelen.

Het gedeelte Skills bevat ook instellingen om Skills voor de hele workspace, in gekoppelde agents of voor lokale downloads uit te schakelen.

Er zijn een paar manieren om een skill te verwijderen, afhankelijk van wat je wilt:

• De Skill volledig verwijderen: Een Skill is een pagina, dus je kunt die net als elke andere pagina naar de prullenbak verplaatsen. Dit werkt ook voor Skill-pagina's in een Skills-database. Als je de pagina verwijdert, verdwijnt de Skill voor iedereen die deze gebruikt.

• Een toegevoegde Skill verwijderen: Heb je een Skill toegevoegd vanuit het tabblad Ontdekken en wil je die niet meer? Zet dan de schakelaar uit in de kolom Voor mij inschakelen op het

  tabblad Skills van je Bibliotheek. Daarmee verwijder je de Skill voor jezelf in de Notion-agent en je gekoppelde agents. De Skill blijft beschikbaar voor alle anderen.

• Van een Skill-pagina weer een gewone pagina maken: Selecteer ••• bovenaan de pagina, selecteer Gebruiken met AI en schakel Gebruiken als AI-Skill uit. Je kunt ook Pagina niet langer als Skill instellen selecteren in het instellingenmenu van de Skill. De pagina en de content blijven staan, maar de pagina is geen Skill meer.

• Gebruik je Notion-agent om te helpen bij het brainstormen of schrijven van skills.

• Begin met een veelvoorkomende workflow die je wekelijks uitvoert, zoals herschrijven, recap'en, samenvatten of opmaken.

• Schrijf je skill als een sterke prompt, inclusief het doel, input, beperkingen en het gewenste output-formaat.

• Maak output-eisen expliciet, zoals "geef 5 /bullet terug" of "voeg risico's en volgende stappen toe."

• Houd de skill-pagina kort en link indien nodig naar langere referenties.

• Itereer in de loop van de tijd door de skill-pagina bij te werken naarmate je leert wat het beste werkt.

• Beschrijf voor elke skill duidelijk wat die doet en wanneer je die gebruikt. De Notion-agent en je gekoppelde agents gebruiken die beschrijving om zelf de juiste skill te kiezen.

• Als je team ook met lokale agenten werkt, houd de skill-pagina in Notion dan up-to-date en download deze opnieuw nadat je wijzigingen hebt aangebracht.

• Geef elke gedeelde Skill een eigenaar, zodat één persoon deze actueel houdt naarmate het proces van je team verandert.

Agents lezen de naam en beschrijving van elke skill die je hebt ingeschakeld voordat ze er een kiezen. Deze limieten houden die lijst overzichtelijk, zodat agents snel de juiste skill kiezen:

Als een gekoppelde agent enkele van je skills mist, schakel dan de skills uit die je niet nodig hebt voor gekoppelde agents.