Praktisch AI-advies voor teams en leiders

Eerste stappen. Geavanceerde AI.

Gepubliceerde gidsBijgewerkt

Hoofdstuk 7 van 20Voorbereiden

Hoofdstukkenmenu20 hoofdstukken

Voeg vier handige skills toe

Geef Codex vier duidelijke werkwijzen voor ontwerp, leesbare code, testen en beveiliging.

Kooka, een vriendelijke kookaburra-docent met een bril en een blauw notitieboek.

Deze vier skills helpen Codex duidelijke ontwerp- en kwaliteitsroutines te volgen.

Volg de afbeeldingen

Voorbeelden ter illustratie. Jouw app kan er anders uitzien. Tik op een afbeelding om deze te vergroten. De illustraties gebruiken Engelse voorbeeldlabels. De stappen en uitleg zijn vertaald.

  1. Download de vier skills

    Download en lees de vier skills: ontwerp, nette code, testen en beveiliging.

    Illustratie: download en lees de vier basisskills voor ontwerp, code, testen en beveiliging.
    Voorbeeld ter illustratie
    Download
    website-design · clean-code · website-testing · website-security

    Let op: Je hebt alle vier de basisbestanden gelezen voordat je ze gebruikt.

    Meer hulp bij deze actie

    Een skillmap bevat SKILL.md met een naam, beschrijving en instructies. Codex vindt projectskills onder .agents/skills en leest de volledige uitleg wanneer het ze gebruikt. website-design behandelt de visuele richting; clean-code begrijpelijke bouw; website-testing bezoekersroutes; website-security beveiligingsgrenzen. Deze workshopinstructies garanderen geen veilige of foutloze site.

    Toon de stappen
    1. Download de vier basisskills: website-design, clean-code, website-testing en website-security. Lees ze vóór gebruik; controleer scripts waarnaar skills van derden verwijzen.
    2. Elke skill is een gerichte set instructies. Lees wat je Codex vraagt te volgen.
    3. Bevat een skill van iemand anders scripts? Bekijk die voordat je ze uitvoert.
    4. De langere downloadnamen houden de bestanden uit elkaar; de uiteindelijke naam binnen elke map is SKILL.md.

    Dit zou je nu moeten zien: Je hebt alle vier de basisbestanden gelezen voordat je ze gebruikt.

  2. Zet elk bestand in zijn map

    Vraag Codex de skillmappen voor te bereiden. Verplaats elke download naar de juiste map en hernoem het bestand naar SKILL.md.

    Illustratie: elke skill heeft een eigen map en een apart bestand met de naam SKILL.md.
    Voorbeeld ter illustratie
    Mappad
    fieldnotes-studio → .agents → skills → Eén map per skill
    Elk bestand
    Bijbehorende skillmap → SKILL.md

    Let op: Alle vier de skills staan op de exacte paden uit de mapstructuur.

    Meer hulp bij deze actie

    Volg deze stappen als je meer uitleg wilt.

    Toon de stappen
    1. Volg de instructies voor projectskills: maak in fieldnotes-studio .agents/skills en daarbinnen de mappen website-design, clean-code, website-testing en website-security.
    2. Gebruik de vereiste mapstructuur. Verplaats elke download naar de juiste map en hernoem hem naar SKILL.md, zodat elke map een eigen SKILL.md bevat.
    3. Vraag Codex alleen de vier mappen uit Vereiste skillstructuur te maken, zonder de website te bouwen.
    4. Verplaats website-design-SKILL.md naar .agents/skills/website-design en hernoem het naar SKILL.md. Herhaal dat in de juiste mappen voor de andere drie.
    5. Is .agents verborgen? Gebruik Finder Command + Shift + punt of Windows View → Show → Hidden items. Laat Codex de exacte eindpaden vergelijken.

    Dit zou je nu moeten zien: Alle vier de skills staan op de exacte paden uit de mapstructuur.

  3. Controleer het label van elke skill

    Controleer of elk SKILL.md begint met name en description. Houd de naam gelijk aan de mapnaam en sla op als gewone tekst.

    Illustratie: controleer de naam en beschrijving van elke skill en vergelijk de naam met de map.
    Voorbeeld ter illustratie
    Controleer
    SKILL.md → name + description → Naam past bij de map

    Let op: Elke skill heeft geldige name- en description-metadata en is opgeslagen als gewone tekst.

    Meer hulp bij deze actie

    Volg deze stappen als je meer uitleg wilt.

    Toon de stappen
    1. Controleer de specificatie van skillmetadata. Behoud name en description bovenaan, laat elke naam bij de map passen en sla op als gewone tekst.
    2. Bovenaan staat een metadatablok met name en description tussen twee regels met ---.
    3. Laat de vier namen overeenkomen met hun mappen: website-design, clean-code, website-testing, website-security.
    4. Behoud de basismetadata tenzij je een duidelijke reden hebt om die te veranderen; vermijd lange of tegenstrijdige instructies.

    Dit zou je nu moeten zien: Elke skill heeft geldige name- en description-metadata en is opgeslagen als gewone tekst.

  4. Controleer of Codex ze kan lezen

    Begin een nieuwe projectchat en verstuur de controleprompt voor vier skills. Laat Codex elk bestand lezen en ontbrekende bestanden melden.

    Illustratie: laat een nieuwe Codex-chat alle vier de skillbestanden bekijken.
    Voorbeeld ter illustratie
    In Codex
    New chat → Vier-skills-prompt kopiëren → Versturen

    Let op: Codex leest alle vier de bestanden en legt uit wanneer het elke werkwijze toepast.

    Meer hulp bij deze actie

    Volg deze stappen als je meer uitleg wilt.

    Toon de stappen
    1. Gebruik de prompt om skills te vinden in een nieuwe projectchat. Codex herkent wijzigingen automatisch; herstart als de bestanden niet verschijnen.
    2. Vergelijk de gemelde paden met de echte bestanden. Vraag naar ongeldige of ontbrekende bestanden in plaats van aan te nemen dat alles klopt.
    3. Codex herkent skillwijzigingen automatisch; herstart als de bestanden niet verschijnen.
    4. Controleer of fieldnotes-studio de hoofdmap van het project is. De skills vinden bewijst niet dat elke werkwijze is toegepast.

    Dit zou je nu moeten zien: Codex leest alle vier de bestanden en legt uit wanneer het elke werkwijze toepast.

  5. Probeer de ontwerpskill

    Verstuur de prompt voor de ontwerpskill. Noem website-design rechtstreeks en vraag vóór de bouw om een plan.

    Illustratie: roep website-design rechtstreeks aan en controleer het plan vóór de bouw.
    Voorbeeld ter illustratie
    In Codex
    Ontwerpskill-prompt kopiëren → website-design gebruiken → Plan beoordelen

    Let op: Rechtstreeks aanroepen levert een ontwerpplan op dat je kunt beoordelen.

    Meer hulp bij deze actie

    Volg deze stappen als je meer uitleg wilt.

    Toon de stappen
    1. Probeer de prompt om de ontwerpskill rechtstreeks aan te roepen. Noem de skill of het pad; de officiële uitleg behandelt ook optionele CLI- en IDE-notatie.
    2. De prompt geeft .agents/skills/website-design/SKILL.md als exact pad.
    3. Laat Codex het bestand lezen en de resultaten en beoordelingscontroles van de werkwijze uitleggen.
    4. Controleer het plan vóór de bouw. Je kunt de skill gewoon noemen zonder CLI- of IDE-keuzemenu’s te gebruiken.

    Dit zou je nu moeten zien: Rechtstreeks aanroepen levert een ontwerpplan op dat je kunt beoordelen.

  6. Bewaar de skills in Git

    Controleer de vier bestanden en laat Codex de skillmappen als commit opslaan. Bewaar alleen de bedoelde wijzigingen.

    Illustratie: controleer de vier bedoelde skillbestanden en sla ze in Git op als commit.
    Voorbeeld ter illustratie
    Bewaar
    .agents/skills controleren → Vier bestanden klaarzetten → Commit

    Let op: Git bewaart de vier gecontroleerde skills, zodat medewerkers dezelfde instructies kunnen bekijken.

    Meer hulp bij deze actie

    Volg deze stappen als je meer uitleg wilt.

    Toon de stappen
    1. Controleer alle vier de bestanden en bewaar ze als Git-commit, zodat toekomstige medewerkers dezelfde instructies kunnen bekijken.
    2. Laat de vier uiteindelijke paden tonen en controleer ze vóór het opslaan.
    3. Zet alleen de bedoelde SKILL.md-bestanden klaar en controleer daarna de klaargezette wijzigingen.
    4. Gebruik bijvoorbeeld het bericht Add website workflow skills. Houd andere openstaande wijzigingen apart; een commit bewijst niet dat websitecontroles slagen.

    Dit zou je nu moeten zien: Git bewaart de vier gecontroleerde skills, zodat medewerkers dezelfde instructies kunnen bekijken.

Waarom deze stap belangrijk is

Een skill is een herbruikbare werkwijze in een SKILL.md-bestand. Projectskills staan in .agents/skills, zodat Codex ze kan vinden.

Deze vier werkwijzen helpen bij ontwerp, nette code, testen en beveiligingscontrole. Ze kunnen niet garanderen dat een website veilig of foutloos is.

De basis uitgelegd

Skill

Een herbruikbare set instructies voor een bepaalde taak, eventueel met hulpmiddelen, die een agent helpt een specifieke werkwijze te volgen.

Metadata

Korte beschrijvende informatie bovenaan een skillbestand, zoals de naam en wanneer je de skill gebruikt.

Expliciet aanroepen

De agent rechtstreeks vragen een genoemde skill te gebruiken, in plaats van te wachten tot hij die zelf kiest.

Verborgen map

Een map die een bestandsvenster standaard kan verbergen. Namen die met een punt beginnen, zoals .agents, zijn op macOS en Linux vaak verborgen.

Vraag het je agent

PromptControleer alle vier de skills

Kopieer naar Codex en pas de tekst aan je project aan.

Bekijk .agents/skills. Lees de vier SKILL.md-bestanden en bevestig hun namen en paden. Leg uit wanneer je elke werkwijze toepast. Meld ongeldige of ontbrekende bestanden. Bouw nog niets en installeer nog geen hulpmiddelen.
PromptRoep de ontwerpskill aan

Kopieer naar Codex en pas de tekst aan je project aan.

Gebruik website-design in .agents/skills/website-design/SKILL.md. Lees het bestand en pas de planningswerkwijze toe op Fieldnotes Studio. Leg vóór de bouw uit welke concrete resultaten en beoordelingscontroles het oplevert.

Bestanden & opdrachten

textVereiste skillstructuur

Lees deze stap voordat je het voorbeeld gebruikt.

fieldnotes-studio/
  AGENTS.md
  .agents/
    skills/
      website-design/SKILL.md
      clean-code/SKILL.md
      website-testing/SKILL.md
      website-security/SKILL.md
Controleer je werk

Vink elk punt aan nadat je het zelf hebt gecontroleerd. Je kunt het vinkje altijd verwijderen.

Als er iets misgaat
.agents is verborgen.
Gebruik in macOS Finder Command + Shift + punt. Gebruik op Windows zo nodig View > Show > Hidden items.
Codex negeert de skill nadat ik die noem.
Geef het exacte pad. Vraag Codex het bestand te lezen, de relevante eisen te noemen en uit te leggen hoe het resultaat eraan voldoet.
Persoonlijke notities

Noteer vragen, besluiten of ideeën voor je website. Waar mogelijk opgeslagen in deze browser; exporteer je notities om een kopie te bewaren. Vul nooit geheimen in.

Downloads & opgeslagen voortgangGids, notities en persoonlijke controles

Download de volledige gids of exporteer je notities uit alle hoofdstukken. Instructies voor het laatst gecontroleerd: .

Download gids .md Ga naar startbestanden

Controles en notities blijven in deze browser, apart per taal. Exporteer je notities om ze te bewaren. Vul hier nooit API-sleutels of andere geheimen in.

StartbestandenWerkinstructies en vier skills

Deze sjablonen geven je agent een eerste set werkinstructies. Lees ze, pas ze aan je website aan en sla elk bestand op het getoonde pad op, gerekend vanaf je projectmap.

Een gedownloade skill is een instructiebestand. Het installeert geen testprogramma, voert geen beveiligingsscan uit en bewijst niet dat je site veilig is. De gids laat zien hoe je dat werk opzet en controleert.

Download de instructiebestanden in de taal van deze gids. Houd de technische bestandsnamen en paden gelijk aan de voorbeelden.

Download alle startbestanden .md-bundel
BestandAGENTS.md

Sla op het bovenstaande pad op.

Download bestand
# Werkafspraken voor de website

Dit project volgt de websitebrief en acceptatiecriteria die met de eigenaar zijn afgesproken. Gebruik de bestaande technische keuzes, tenzij een concrete eis om een wijziging vraagt.

## Werkwijze

- Leg bij een grote functie vóór de bouw de voorgestelde wijzigingen en het controleplan uit. Rond toegestaan lokaal werk af in kleine stappen die de eigenaar kan beoordelen.
- Lees de bestanden die bij de taak horen. Houd andere pagina’s en instellingen intact.
- Leg nieuwe technische termen in gewone taal uit wanneer je aan de eigenaar rapporteert.
- Gebruik de skills website-design, clean-code, website-testing en website-security uit de repository wanneer hun werkwijzen van toepassing zijn.
- Leg belangrijke beslissingen en ontbrekende inhoud vast in de projectnotities. Verzin geen bedrijfsfeiten, aanbevelingen of publicatierechten.

## Controle

- Bekijk package.json om de echte commando’s voor bouwen, typecontrole en tests te vinden. Verzin geen geslaagde controle en maak geen betekenisloze test alleen om een commando te laten slagen.
- Voer controles uit die bij de wijziging passen. Lokale tests gebruiken tijdelijke testgegevens en hebben geen toegang tot productie; voer ze uit en herstel fouten door de gevraagde wijziging zonder bij elke stap toestemming te vragen.
- Controleer bezoekersinteracties in een browser wanneer browserhulpmiddelen beschikbaar zijn. Meld controles die onbeschikbaar of onvolledig blijven.
- Toon de eigenaar een werkende lokale preview en vat veranderd gedrag, bewijs en resterende beperkingen samen.

## Toegangsgegevens en publicatie

- Houd API-sleutels en andere geheimen buiten browsercode, prompts, logboeken en Git. Bewaar lokale geheimen in genegeerde bestanden of de gekozen beveiligde opslag.
- Lokaal bouwen en testen is toegestaan. De site publiceren, een echt bericht versturen, een betaling verwerken of productiegegevens wijzigen vereist toestemming van de eigenaar voor die handeling.
- Bewaar vóór publicatie een herstelbare werkende versie. Beschrijf hoe je die terugzet.

Dit zijn basisafspraken voor een nieuw oefenproject. Pas ze aan de echte eisen en al gegeven toestemming van de eigenaar aan.
Bestand.agents/skills/website-design/SKILL.md

Sla op het bovenstaande pad op.

Download bestand
---
name: website-design
description: Ontwikkel of verfijn de visuele richting en responsive interface van een website vanuit de brief, inhoud en het bestaande ontwerp. Gebruik voor paginaontwerp of visuele bouw.
---

Lees de websitebrief en bestaande ontwerpnotities voor de gevraagde pagina. Werk binnen de merkkeuzes, inhoud en technische keuzes van de gebruiker.

Stel bij een nieuwe richting letterkeuzes, een klein kleurenpalet, vaste afstanden en een voorbeeldpagina voor. Leg uit hoe deze keuzes de doelgroep en de hoofdactie van bezoekers ondersteunen. Gebruik echte inhoud om de volgorde van aandacht en regellengtes te beoordelen.

Maak herbruikbare onderdelen voor navigatie, koppen, knoppen en herhaalde inhoud. Geef hoofdacties een duidelijke visuele nadruk. Behoud zichtbare toetsenbordfocus, leesbaar contrast en bruikbare labels. Ontwerp smalle schermen naast desktopschermen; controleer lange koppen, navigatie en aanraakvlakken in een browser.

Gebruik betekenisvolle HTML voordat je aangepaste interactie toevoegt. Maak beweging optioneel en respecteer de voorkeur voor minder beweging. Gebruik materiaal waarvoor publicatierechten bekend zijn en noteer de bronnen. Verzin geen klantbeoordelingen, prestaties of bedrijfsfeiten.

Toon vóór uitbreiding naar alle pagina’s de eerste complete pagina op desktop- en telefoonbreedte. Beschrijf de belangrijkste ontwerpkeuzes en ontbrekende inhoud. Is een browserhulpmiddel onbeschikbaar? Meld dan dat visuele controle nog moet gebeuren.
Bestand.agents/skills/clean-code/SKILL.md

Sla op het bovenstaande pad op.

Download bestand
---
name: clean-code
description: Bouw of herstructureer websitecode tot begrijpelijke onderdelen met de bestaande techniek en afspraken van het project. Gebruik voor websitebouw of onderhoudbaarheid.
---

Lees de relevante bestanden en pakketscripts voordat je een aanpak kiest. Behoud werkend gedrag buiten de gevraagde wijziging. Gebruik bij voorkeur de bestaande techniek en pakketten als die aan de behoefte voldoen.

Houd pagina-inhoud apart van herhaalde opmaak wanneer dat bewerken makkelijker maakt. Geef onderdelen, variabelen en functies namen die hun doel beschrijven. Gebruik gedeelde onderdelen voor herhaalde navigatie en pagina-elementen; maak geen abstractie voor één eenvoudig gebruik.

Verwerk lege, ongeldige, ladende en fouttoestanden bij interacties die dat nodig hebben. Gebruik standaard browserbediening en betekenisvolle HTML wanneer die de interactie ondersteunen. Vermijd nep-formulierverzending, nagebootste succesmeldingen en dode links.

Gebruik typecontrole en de opmaak- of lintregels van het project waar die zijn ingesteld. Leg bij een nieuw pakket het doel en nieuwe onderhouds- of gebruikseisen uit. Houd gegenereerde bouwbestanden, geïnstalleerde pakketten en lokale omgevingsbestanden buiten versiebeheer.

Voer bestaande controles uit die bij de wijziging passen, inclusief een productiebuild wanneer het resultaat kan veranderen. Vat veranderd gedrag, controleresultaten en resterende beperkingen samen. Leg de belangrijkste bestanden in gewone taal uit, zodat een beginner de inhoud kan vinden en aanpassen.
Bestand.agents/skills/website-testing/SKILL.md

Sla op het bovenstaande pad op.

Download bestand
---
name: website-testing
description: Controleer websitewijzigingen met bezoekersroutes, passende automatische tests en browsercontroles. Gebruik bij websitetests, onderzoek naar fouten of voorbereiding op publicatie.
---

Begin met de brief en zichtbare acceptatiecriteria. Bekijk bestaande test- en bouwcommando’s; neem niet aan dat een script bestaat. Kies controles op basis van veranderd gedrag en de gevolgen van een fout.

Doorloop de hoofdroute voor bezoekers en betrokken links, navigatie en formulieren. Neem ongeldige invoer en relevante fouttoestanden mee. Controleer bij een contactformulier echte bezorging op de afgesproken testbestemming voordat je meldt dat het werkt. Leg bij een e-maillink uit dat die het ingestelde mailprogramma van de bezoeker opent en niet automatisch een bericht verstuurt.

Controleer smalle en brede schermen in een browser. Neem toetsenbordnavigatie, zichtbare focus, toegankelijke namen, zoom en horizontaal overlopen mee. Automatische toegankelijkheidsresultaten vullen deze handmatige controles aan en bewijzen geen volledige toegankelijkheidsnaleving.

Voeg automatische tests toe voor belangrijk gedrag of aangetoonde terugkerende fouten. Test zichtbare resultaten en betekenisvolle foutgevallen; vermijd tests die alleen de geschreven code herhalen of toevallige formuleringen vergelijken. Gebruik tijdelijke testgegevens en lokale testbestanden. Verstuur nooit echte berichten, voer geen betalingen uit en wijzig geen productiegegevens zonder toestemming van de gebruiker.

Reproduceer een fout, herstel de oorzaak en voer betrokken controles opnieuw uit. Meld uitgevoerde commando’s, resultaten, browsercontroles en alles wat niet is gecontroleerd. Een geslaagde build toont dat de site kan worden gemaakt; controleer bezoekersgedrag apart. Meld nooit dat een controle geslaagd is als die is overgeslagen of onbeschikbaar was.
Bestand.agents/skills/website-security/SKILL.md

Sla op het bovenstaande pad op.

Download bestand
---
name: website-security
description: Controleer geheimen, pakketten, invoer, toegang en publicatie-instellingen van een website en herstel bevindingen binnen de afgesproken taak. Gebruik voor gevraagde beveiligingscontrole of voorbereiding op publicatie.
---

Breng de relevante onderdelen van de site in kaart: statische pagina’s, formulieren, backend-routes, aanmelding, scripts van derden en opgeslagen gegevens. Beperk de controle tot de echte technische opzet en de toegestane omgeving.

Houd toegangsgegevens buiten browsercode, logboeken, prompts en Git. Maak onderscheid tussen openbare instellingen tijdens de build en servergeheimen. Is een sleutel als commit opgeslagen of blootgesteld? Gebruik hem niet meer, leg uit dat het bestand verwijderen de sleutel niet intrekt en laat de eigenaar hem vóór verder gebruik intrekken of vervangen. Toon de toegangsgegevens niet in je verslag.

Bekijk relevante beveiligingswaarschuwingen voor pakketten en beoordeel of het betrokken pakket en het kwetsbare gedrag worden gebruikt. Herstel binnen compatibele versies en voer de betrokken controles opnieuw uit. Vermijd automatische geforceerde upgrades die de website kunnen breken.

Controleer bij backend-interacties de invoer op de server, geef uitvoer passend gecodeerd weer en controleer aanmelding en toegangsrechten afzonderlijk. Overweeg misbruikbeperking voor openbare formulieren of AI-toegangspunten. Een OpenAI API-sleutel hoort op de server; een statische site publiceren biedt geen geheime serveromgeving.

Controleer HTTPS en relevante beveiligingsheaders bij de echte hosting. Verzamel alleen gegevens die de functie nodig heeft en leg hun bestemming en bewaartermijn uit. Claim geen wettelijke naleving op basis van een codescan.

Meld elke bevinding met locatie, aannemelijke impact, herstel en controle. Beschrijf de reikwijdte, gebruikte hulpmiddelen, openstaande bevindingen en ontoegankelijke onderdelen. Een schone scan is bewijs binnen het bereik van die scan, geen garantie dat de website geen kwetsbaarheden heeft. Scan geen systemen van derden en publiceer geen wijzigingen buiten de toegestane taak.
Terug naar het begin van het hoofdstuk