Skills aanmaken en beheren

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

• Werkt voor het hele team. Iedereen kan een skill schrijven in de Notion-editor, zonder markdown te gebruiken. Teamgenoten kunnen opmerkingen en wijzigingen voorstellen, en een skill kan linken naar elke pagina in je workspace.

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

• Ingebouwde beheerfuncties. Skills zijn pagina's, dus paginarechten 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.

Vuistregel: als je dezelfde prompt twee keer zou kopiëren en plakken, kun je er beter een skill van maken.

• 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épagina voor de skill aan en opent die. Schrijf je instructies en voeg 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 de 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 deze 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 die op je computer staan naar Notion te uploaden. Je kunt de agent later ook vragen een skillmap te uploaden.

• Verander een database met handleidingen in skills: Leer hoe je een bestaande database verandert in een skill-database →

Als je een skill inschakelt, kun je die gebruiken in de Notion-agent en in je gekoppelde agents. Als je de skill uitschakelt, is die in geen van beide 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 de Notion-agent gebruiken, maar niet in je gekoppelde agents? Open dan het instellingenmenu via het pictogram met schuifregelaars naast de skill of bovenaan de skillpagina. Houd onder Andere agents de muisaanwijzer op 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 worden uitgevoerd. Voeg er een toe in het veld Beschrijving bovenaan de skillpagina, of in de eigenschap Beschrijving als de skill in een skilldatabase 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 zijn ingesteld om op een pagina te worden weergegeven, verschijnen in deze menu's. Om dit te wijzigen, open je het instellingenmenu van de skill op het tabblad Skills in je Bibliotheek en selecteer je Skill weergeven. Je eigen skills verschijnen eerst, gevolgd door de ingebouwde standaardskills: 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 bij 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 uitgeschreven, of notulen met een afgeronde samenvatting.

2. Je ziet voorgestelde skills bij de notulen. Je kunt ze ook bekijken door de Notion-agent te openen via het gezichtspictogram onderaan de notulen.

3. Selecteer een voorgestelde skill om deze uit te voeren, zoals het samenvatten van beslissingen tijdens de vergadering of het maken van vervolgtaken nadat deze is afgelopen. Je kunt hier ook een nieuwe skill maken.

Je ziet tijdens de vergadering andere suggesties dan nadat deze is afgelopen. Om te kiezen welke skills bij de notulen verschijnen, ga je naar Bibliotheek → Skills, open je het instellingenmenu van de skill, selecteer je Skill weergeven en schakel je Tijdens vergaderingen, Na vergaderingen, of beide in. Elke lijst bevat maximaal 12 skills.

Lees meer over AI-notulen →

Er zijn drie manieren om je Notion-skills buiten Notion te gebruiken. Bij elke manier blijft Notion de plek waar skills worden geschreven en onderhouden.

Agents die via MCP met Notion zijn verbonden, kunnen aan het begin van elke sessie je skills uit Notion laden en de juiste kiezen voor de taak. Wanneer je een skill in Notion bewerkt, krijgt elke verbonden agent de update. Je hebt eerst een werkende Notion MCP-verbinding nodig.

1. Open Library → Skills.

2. Selecteer Set up in de banner met de tekst Use your skills with connected agents?

3. Selecteer Copy 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 in elke sessie te laden en biedt aan om skills die al op je computer staan te uploaden.

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 Notion-skills naar een GitHub-repository. Je beheerder kan die repository vervolgens toevoegen als plugin-marktplaats in Claude of ChatGPTcodex, zodat 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 lokale downloads van skills toestaat.

1. Open de skillpagina in de Notion-desktopapp.

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

3. Selecteer onder Other agents de optie Download for local 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. Wanneer de skill in Notion wordt gewijzigd, wordt de gedownloade kopie gemarkeerd als verouderd, zodat je weet dat je deze opnieuw moet downloaden.

Ontwikkelaars kunnen skills ook weergeven, downloaden en uploaden met de Agent Skills API. Zie de developer docs →

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 Library

De Skills Library is geen database. Het is een weergave die alle skills waar je toegang toe hebt in 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 standaardinstellingen om nieuwe eigenschappen te maken. Vink het vakje Enable skills for me aan om de bestaande pagina's ook meteen als skills voor jezelf in te schakelen. Bij het vakje staat om hoeveel pagina's het gaat.

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.

Om de content van een skill te bewerken vanuit het tekstselectiemenu, houd je de muisaanwijzer op de naam en selecteer je het potloodpictogram. Je kunt ook de pagina van een skill openen vanuit de Skills Library of de skilldatabase 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. Om te kiezen waar een skill verschijnt, open je het instellingenmenu en selecteer je Show skill. Kies In a page voor de teksteditor, het slashmenu en het blokmenu, In chat voor de chat met de Notion-agent en During meetings of After meetings 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.

• Er een gevonden die je wilt? Zet de schakelaar in de kolom Enable for me aan om deze 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 en een skill inschakelen zijn twee verschillende dingen. Toegang bepaalt wie een skill kan openen of bewerken. Inschakelen bepaalt of deze in je eigen skillmenu verschijnt. Skills die met jou zijn gedeeld, verschijnen op het tabblad Discover van je Bibliotheek, waar je ze kunt inschakelen in de kolom Enable for me.

Skillanalyses laten zien hoe vaak een skill wordt uitgevoerd, in Notion en in andere agents.

• In je bibliotheek: De kolom Uses in Library → Skills laat zien hoe vaak mensen in je workspace elke skill de afgelopen 28 dagen hebben gebruikt, inclusief gebruik in gekoppelde agents via MCP.

• Voor één skill: Open het instellingenmenu van de skill en selecteer View analytics om te zien hoe het gebruik ervan 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 Settings → Notion AI → General en zoek Default workspace skills in het gedeelte Skills.

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

2. Selecteer Add skill en kies de skills die je wilt installeren.

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

Standaardskills worden automatisch voor leden geïnstalleerd, ook in hun gekoppelde agents. Leden kunnen een standaardskill nog steeds voor zichzelf uitschakelen.

Het gedeelte Skills bevat ook instellingen om skills voor de hele workspace uit te schakelen, om skills in gekoppelde agents uit te schakelen en om het lokaal downloaden van skills uit te schakelen.

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

• Een skill volledig verwijderen: Een skill is een pagina, dus je kunt deze net als elke andere pagina naar de Prullenbak verplaatsen. Dit werkt ook voor skillpagina's in een skilldatabase. Houd er rekening mee dat de skill daarmee verdwijnt voor iedereen die deze gebruikt.

• Een skill verwijderen die je hebt toegevoegd: Als je een skill hebt toegevoegd vanuit het tabblad Discover en die niet meer wilt, zet je de schakelaar in de kolom Enable for me uit op het

  Skills-tabblad 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.

• Een skillpagina weer omzetten naar een gewone pagina: Selecteer ••• bovenaan de pagina, selecteer Use with AI en schakel vervolgens Use as AI skill uit. Je kunt ook Unset page as skill selecteren in het instellingenmenu van de skill. De pagina en de content blijven gewoon staan waar ze staan. Het is dan 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.

• Geef elke Skill een duidelijke beschrijving van wat deze doet en wanneer je deze moet gebruiken. De Notion-agent en je gekoppelde agents gebruiken de 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 de lijst overzichtelijk, zodat agents snel de juiste Skill kiezen:

Als een gekoppelde agent niet al je Skills ziet, schakel dan de Skills uit die je niet nodig hebt voor gekoppelde agents.