Module 10 Module 10

Skills

A skill is a saved playbook: teach Codex how to do a recurring task once, and it can repeat it reliably forever. Think of it as turning "here's exactly how we file an expense" into a button. We'll cover what skills are, how to make them — and one important limit for EU users.

Skills

Een skill is een opgeslagen draaiboek: leer Codex één keer hoe een terugkerende taak werkt, en het kan die voor altijd betrouwbaar herhalen. Zie het als "zo dienen we precies een declaratie in" omgezet in een knop. We behandelen wat skills zijn, hoe je ze maakt — en één belangrijke beperking voor EU-gebruikers.

⏱ 15 min⏱ 15 min ReuseHergebruik

What a skill is

Wat een skill is

A skill is a small, reusable package of instructions (and sometimes helper files) that tells Codex how to perform a specific workflow well. Where AGENTS.md sets general rules for a whole project, a skill captures one specific procedure — "produce the monthly report exactly the way we like it," step by step, including how to check it's correct.

The payoff: you stop re-explaining the same multi-step task. You build it once; Codex performs it consistently.

Een skill is een klein, herbruikbaar pakket instructies (en soms hulpbestanden) dat Codex vertelt hoe het een specifieke werkwijze goed uitvoert. Waar AGENTS.md algemene regels voor een heel project zet, legt een skill één specifieke procedure vast — "maak het maandrapport precies zoals wij het willen," stap voor stap, inclusief hoe je controleert of het klopt.

De winst: je hoeft dezelfde meerstaps-taak niet steeds opnieuw uit te leggen. Je bouwt het één keer; Codex voert het consistent uit.

How you trigger one

Hoe je er een start

Once a skill exists, Codex can use it two ways:

  • Explicitly — you call it by name (e.g. typing /skills to pick one).
  • Implicitly — Codex notices your request matches a skill's description and offers to use it automatically.

Behind the scenes Codex first reads only each skill's short name and description, and loads the full instructions only when one is actually needed — so having many skills doesn't slow it down.

Zodra een skill bestaat, kan Codex die op twee manieren gebruiken:

  • Expliciet — je roept het bij naam aan (bijv. /skills typen om er een te kiezen).
  • Impliciet — Codex merkt dat je verzoek bij de beschrijving van een skill past en biedt aan het automatisch te gebruiken.

Achter de schermen leest Codex eerst alleen de korte naam en beschrijving van elke skill, en laadt het de volledige instructies pas wanneer er echt een nodig is — dus veel skills hebben vertraagt het niet.

Three ways to create skills

Drie manieren om skills te maken

  1. Guided — ask Codex to help: run a skill-builder ($skill-creator) and answer its questions. The most approachable route for non-coders.
  2. Manual — create a small folder with a SKILL.md file describing the steps, saved either in a project (.agents/skills) or for yourself (~/.agents/skills). It's just writing instructions in a text file.
  3. Record & Replaydemonstrate a workflow with your mouse and keyboard, and Codex watches and drafts a skill from it. Magical — but limited, as the next section explains.
  1. Begeleid — vraag Codex om hulp: start een skill-bouwer ($skill-creator) en beantwoord de vragen. De toegankelijkste route voor niet-programmeurs.
  2. Handmatig — maak een kleine map met een SKILL.md-bestand dat de stappen beschrijft, opgeslagen in een project (.agents/skills) of voor jezelf (~/.agents/skills). Het is gewoon instructies in een tekstbestand schrijven.
  3. Record & Replaydoe een werkwijze voor met je muis en toetsenbord, en Codex kijkt mee en stelt er een skill van op. Magisch — maar beperkt, zoals de volgende sectie uitlegt.

The EU / Windows reality check

De EU / Windows-realiteitscheck

This matters for this audience specifically, so we'll be direct:

⚠ Important

Record & Replay is macOS-only, and at launch it is not available in the EEA, the UK, or Switzerland. If you're on Windows in the Netherlands (or anywhere in the EU), you cannot use the demonstrate-a-workflow capture. It also requires Computer Use to be enabled.

So what should a Windows/EU non-coder do? Use the guided and manual methods instead. The skill files themselves are just text and work across platforms — it's only the macOS "record your screen" capture that's restricted. You lose a convenience, not the capability: you can still build excellent skills by describing the steps (or having Codex help you write them).

Dit is juist voor deze doelgroep belangrijk, dus we zijn direct:

⚠ Belangrijk

Record & Replay is alleen voor macOS, en bij lancering niet beschikbaar in de EER, het VK of Zwitserland. Zit je op Windows in Nederland (of ergens in de EU), dan kun je de voordoen-en-opnemen-functie niet gebruiken. Het vereist ook dat Computer Use is ingeschakeld.

Wat moet een Windows/EU-niet-programmeur dan doen? Gebruik in plaats daarvan de begeleide en handmatige methoden. De skill-bestanden zelf zijn gewoon tekst en werken op alle platforms — alleen de macOS "neem je scherm op"-opname is beperkt. Je verliest een gemak, niet de mogelijkheid: je kunt nog steeds uitstekende skills bouwen door de stappen te beschrijven (of Codex ze te laten helpen schrijven).

Good skill candidates Goede skill-kandidaten

Any task you do repeatedly the same way: assembling a weekly report, formatting a dataset to house style, preparing onboarding documents, turning raw notes into a standard template. If you've explained it more than twice, it's a skill.

Elke taak die je herhaaldelijk op dezelfde manier doet: een weekrapport samenstellen, een dataset naar huisstijl opmaken, onboardingdocumenten voorbereiden, ruwe notities naar een standaardsjabloon omzetten. Heb je het meer dan twee keer uitgelegd, dan is het een skill.

Key takeaway Kernpunt

Skills turn a repeated procedure into a reusable playbook. Create them guided or manually — and note that the slick Record & Replay capture is macOS-only and unavailable in the EU/UK, so EU Windows users build skills the written way.

Skills maken van een herhaalde procedure een herbruikbaar draaiboek. Maak ze begeleid of handmatig — en weet dat de gladde Record & Replay-opname alleen voor macOS is en niet in de EU/VK beschikbaar, dus EU-Windowsgebruikers bouwen skills op de geschreven manier.