mcpField
A
amsterdam-stijl

amsterdam-stijl

github.com/amsterdamMarketing & growth26154 installsUpdated 16w ago
Repository

About amsterdam-stijl

amsterdam-stijl is a writing-guidance skill for people creating Dutch communications for the City of Amsterdam. It emphasizes B1-level clarity, active phrasing, reader-focused language, and inclusive wording.

Key features

  1. 01B1 plain-language guidance
  2. 02Choose u or je by context
  3. 03Active, reader-focused phrasing
  4. 04Rules for text structure and headings
  5. 05Inclusive-language guidance

Use cases

  1. 01Writing municipal website copy
  2. 02Drafting digital form labels and prompts
  3. 03Preparing letters and policy explanations

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/amsterdam/amsterdam-agent-skills --skill amsterdam-stijl

After installing, type/amsterdam-stijlin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
eenvoudige-taal.md
hoofdletters.md
inclusief-taalgebruik.md
juridisch-woordenboek.md
tekstsoorten.md
voorbeelden.md
woordenlijst.md

Details

From the project README

De Stijl van Amsterdam

MANDATORY: ALL user-facing text MUST follow these Amsterdam writing guidelines. This includes UI labels, buttons, headings, error messages, placeholder text, page content, and any Dutch text. Always apply these rules — do not write generic text.

Schrijfrichtlijnen voor alle communicatie van de gemeente Amsterdam. Gebaseerd op de Schrijfwijzer, het Stijlweb en de Correspondentiewijzer.

Schrijfwijzer: amsterdam.nl/schrijfwijzer Stijlweb: amsterdam.nl/stijlweb Standaardniveau: B1 (Heldere Taal) Standaardtaal: Nederlands

Identiteit: drie kernwaarden

Amsterdam communiceert vanuit drie kernwaarden. Elke waarde vertaalt zich naar concreet schrijfgedrag:

KernwaardeBetekenisSchrijfgedrag
ActiefWij nemen initiatief en zijn duidelijkActieve zinnen, concrete acties, duidelijke vervolgstap
OpenWij zijn transparant en toegankelijkBegrijpelijke taal, geen jargon, lezer centraal
IntegerWij zijn eerlijk en betrouwbaarCorrecte informatie, respectvolle toon, inclusief taalgebruik

Verzorgde spreektaal — De stijl van Amsterdam is niet ambtelijk en niet plat. Het is alsof je iemand netjes aanspreekt: duidelijk, direct, menselijk. Schrijf zoals je het zou zeggen tegen een bekende die je niet tutoyeert.

Communicatie is altijd persoon-tot-persoon: niet van "de gemeente" naar "de burger", maar van mij naar u/jou.

Toon en aanspreking

Aanspreking: u of je?

Standaard spreken we alle lezers aan met u (kleine letter), ook voor internet/web.

Je/jij gebruiken we alleen voor:

  • jongeren tot en met 18 jaar
  • social media
  • geselecteerde campagnes en marketing
  • medewerkers van onze organisatie (interne communicatie)
ContextAansprekingVoorbeeld
Brieven, beschikkingen, formele e-mailu"U kunt bezwaar maken..."
Website, app, digitale formulierenu"U kunt dit online aanvragen."
Beleidstekst, raadsstuku"U ontvangt binnen 6 weken bericht."
Interne communicatieje"Wil je dit oppakken?"
Social mediaje"Check de nieuwe regeling"
Chatbot / conversationalje"Wat kan ik voor je doen?"
UI-tekst (formulieren, apps)u"Vul uw postcode in"
Jongeren (t/m 18 jaar)je"Heb je een vraag?"

Beslisboom:

  1. Is het voor jongeren t/m 18 jaar? -> je
  2. Is het social media of een geselecteerde campagne? -> je
  3. Is het interne communicatie (collega's)? -> je
  4. Al het andere -> u (standaard)
Lezer centraal

Schrijf vanuit de lezer, niet vanuit de organisatie. Draai het perspectief om:

NIET (organisatie-centraal)WEL (lezer-centraal)
De gemeente heeft besloten om...U krijgt een nieuw paspoort omdat...
Wij sturen u...U krijgt... / U ontvangt...
Wij bieden de mogelijkheid om...U kunt nu online een vergunning aanvragen.
Wij verzoeken u...Wilt u...
Wij adviseren u...U kunt...
Wij gaan akkoord...U mag...
Het college heeft vastgesteld dat...Uw aanvraag is goedgekeurd.
Wij vs. ik
  • We = namens de gemeente/organisatie: "We beoordelen uw aanvraag." (Voorkeur voor "we" boven "wij" — vriendelijker.)
  • Ik = als je zelf volledig verantwoordelijk bent voor inhoud en opstelling, of als je persoonlijk een actie onderneemt: "Ik bel u morgen terug."
  • Schrijf nooit "de gemeente Amsterdam", "directie X" of "afdeling Y" als het ook met "we" of "ik" kan. Hooguit bij juridische context (rechtspersoon).
"U hebt" of "u heeft"

Beide vormen zijn correct volgens de Taalunie. Kies er een en houd vol binnen dezelfde tekst. Let op bij "u hebt": het wederkerend voornaamwoord is dan "u" (niet "zich"): "U hebt u ingeschreven." Bij "u heeft": "U heeft zich ingeschreven."

Vermijd cliche-beginzinnen
NIETWEL
Naar aanleiding van uw brief...Op 3 maart schreef u ons over...
In antwoord op uw verzoek...U vroeg om...
Hierbij doe ik u toekomen...Hierbij stuur ik u... / Bijgevoegd vindt u...
Wij delen u mede dat...(Begin direct met de inhoud)
Wij berichten u als volgt...(Begin direct met de inhoud)
Positief formuleren

Schrijf wat de lezer wel kan of moet doen, niet wat niet kan. Vermijd ontkenningen.

NIETWEL
U kunt geen aanvraag indienen zonder DigiD.Log in met DigiD om uw aanvraag te doen.
Het is niet toegestaan om hier te parkeren.Parkeer uw auto in de parkeergarage aan de Piet Heinkade.
Vergeet niet om uw handtekening te zetten.Zet uw handtekening onderaan het formulier.

Bij slecht nieuws: toon begrip maar vermijd valse emotie. Niet: "Tot onze spijt stijgt uw erfpachtcanon helaas..." Wel: "Uw erfpachtcanon wordt vanaf 1 januari 2028 ... We begrijpen dat de kostenstijging vervelend voor u kan zijn."

Empathie tonen

Erken de situatie van de lezer, vooral bij afwijzingen of slecht nieuws.

NIETWEL
Uw aanvraag is afgewezen.We begrijpen dat dit niet het antwoord is waarop u hoopte. Uw aanvraag is helaas afgewezen.

Zinsbouw

Regels
  • Streef naar 12-15 woorden per zin, maximaal 18 woorden
  • Een boodschap per zin — splits samengestelde zinnen
  • Actieve zinnen — vermijd passief (worden, zijn + voltooid deelwoord)
  • Geen tangconstructies — zet de werkwoorden bij elkaar
  • Geen nominalisaties — gebruik het werkwoord, niet het zelfstandig naamwoord
  • Vragen stellen — "Wilt u bezwaar maken?" werkt beter dan "U kunt bezwaar maken."
  • Woordvolgorde: bij voorkeur onderwerp -> persoonsvorm -> gezegde
  • Wissel kortere en langere zinnen af voor een natuurlijk ritme
Actief schrijven
NIET (passief)WEL (actief)
De vergunning wordt verleend door de gemeente.De gemeente verleent de vergunning.
Er is besloten dat het pand wordt gesloopt.Wij hebben besloten het pand te slopen.
Het formulier dient te worden ingevuld.Vul het formulier in.
U wordt verzocht contact op te nemen.Neem contact met ons op.
Er wordt gemopperd over het lawaai.De medewerkers klagen over het lawaai.
Tangconstructies vermijden
NIET (tangconstructie)WEL (werkwoorden bij elkaar)
U moet het formulier dat u van ons heeft ontvangen voor 1 maart ingevuld terugsturen.Stuur het ingevulde formulier voor 1 maart terug. U heeft dit formulier van ons ontvangen.
De subsidie die aan u is toegekend voor de verduurzaming van uw woning is verlengd.Uw subsidie voor woningverduurzaming is verlengd.
Het stadsdeel, dat nieuwe openingstijden heeft, stuurde alle inwoners een brief.Het stadsdeel stuurde alle inwoners een brief. Daarin stonden de nieuwe openingstijden.
Nominalisaties vermijden
NIET (nominalisatie)WEL (werkwoord)
Het doen van een aanvraagEen aanvraag doen / Vraag aan
De uitvoering van het besluitHet besluit uitvoeren
Na indiening van het bezwaarschriftNadat u bezwaar heeft ingediend
De beoordeling van uw aanvraagWij beoordelen uw aanvraag
Hij levert een inspanning om tot verbetering te komen.Hij spant zich in om zijn positie te verbeteren.
Zinloze aanlopen vermijden

Voorkom lege openingen die niets toevoegen:

Zinloze aanloopHeldere versie
Het is een feit dat we bewoners moeten betrekken.We moeten bewoners betrekken.
Er is sprake van weerstand rond deze plannen.Deze plannen geven weerstand.
Als het gaat om verlof opnemen moet je dat zelf aanvragen.Als je verlof wilt, moet je dat zelf aanvragen.

Vermijd ook zinnen beginnen met "er" — dat nodigt uit tot de lijdende vorm. Liever: "We hebben snel een oplossing nodig." dan "Er is snel een oplossing nodig."

Twijfelwoorden beperken

Maximaal 1 twijfelwoord per zin, en alleen als de twijfel echt is. Vermijd opeenstapeling van:

  • daar waar mogelijk / daar waar nodig
  • eventueel
  • in geval van (beter: als)
  • in voorkomende gevallen
  • misschien / wellicht
  • zouden kunnen
Beeldspraak en uitdrukkingen vermijden

Gebruik geen beeldspraak, spreekwoorden, gezegden, citaten of staande uitdrukkingen. Lezers met een lagere taalvaardigheid lezen ze letterlijk. Schrijf wat je bedoelt, direct en duidelijk.

"Zullen", "kunnen", "moeten"
  • Kunnen = echte keuze, de lezer mag kiezen
  • Moeten = geen keuze, de lezer is verplicht
  • Zullen = alleen voor toekomst, vaak overbodig en weg te laten

Woordkeuze

Regels
  • Geen jargon — gebruik woorden die iedereen kent
  • Geen vage termen — wees concreet met datums, bedragen, namen
  • Geen afkortingen — schrijf voluit, behalve: AOW, WOZ, btw, BRP
  • Signaalwoorden — gebruik verbindingswoorden: daarom, want, maar, ook, bijvoorbeeld
Veelvoorkomende verboden woorden
VermijdGebruik
krachtensvolgens
conformvolgens
inzakeover
terzakehierover
uwerzijdsvan u, van uw kant
derhalvedaarom
middelsmet, via
ten behoeve vanvoor
met betrekking totover
in het kader vanvoor, vanwege
dient temoet
reedsal
alduszo
teneindeom te
desalniettemintoch, maar

Volledige woordenlijst -> references/woordenlijst.md

Concreet schrijven
NIET (vaag)WEL (concreet)
Binnenkort ontvangt u bericht.U ontvangt voor 15 maart een brief.
Neem contact met ons op.Bel 14 020 of mail naar [email protected].
U betaalt een bijdrage.U betaalt 45 euro.
Het duurt enige tijd.U ontvangt binnen 6 weken een reactie.

Tekststructuur

Omgekeerde piramide

Zet de belangrijkste boodschap eerst. Dan pas de uitleg.

1. Kernboodschap (wat moet de lezer weten/doen?)
2. Uitleg (waarom, hoe?)
3. Achtergrond (context, details)
Alinea's
  • Een onderwerp per alinea
  • Ongeveer 5 regels per alinea, circa 75 woorden
  • Begin met de kernzin — eerste zin = hoofdboodschap van die alinea
  • Witregel tussen alinea's
Koppen en tussenkoppen
  • Kort en informatief — maximaal 5 woorden
  • De lezer moet uit de koppen al begrijpen waar de tekst over gaat
  • Gebruik tussenkoppen bij elke alinea of na elke 2-3 alinea's
  • Let op met vragende koppen: gebruik de vragende vorm alleen als de lezer het antwoord al weet
    • NIET: "Wat betekent dit voor u?" (lezer weet het antwoord nog niet)
    • WEL: "Wat dit voor u betekent"
    • WEL: "Komt u naar het buurtfeest?" (echte vraag/uitnodiging)
Inleiding en afsluiting
  • Inleiding: maximaal 3 zinnen. Verwijs naar eerder contact, toon begrip, wijs vooruit naar het antwoord.
  • Afsluiting: duidelijke vervolgstap of call-to-action. Noem contactpersoon met naam en bereikbaarheid.
NIETWEL
Met vriendelijke groet, Afdeling VergunningenMet vriendelijke groet, Jan de Vries, vergunningverlener. Bel 14 020 als u vragen heeft.
Hopende u hiermede voldoende geïnformeerd te hebben...Misschien hebt u nog vragen. Bel dan met Lieke Sanders, 020 234 5678.
Signaalwoorden

Gebruik verbindingswoorden om de lezer door de tekst te leiden:

  • Reden: want, omdat, daarom, namelijk
  • Tegenstelling: maar, toch, echter (liever: maar)
  • Opsomming: ook, daarnaast, bovendien
  • Gevolg: daarom, daardoor, dus
  • Voorbeeld: bijvoorbeeld, zoals
  • Tijd: daarna, vervolgens, eerst, tot slot

Inclusief taalgebruik

Amsterdam schrijft inclusief. We maken geen aannames over gender, afkomst, beperking of gezinssamenstelling.

Basisregels
  • Genderneutraal als standaard
  • Persoon-eerst bij beperkingen
  • Geen aannames over gezinssituatie, afkomst, opleidingsniveau
Snelle vervangtabel
VermijdGebruik
hij/zijdie, diegene, u, je
de heer/mevrouw(weglaten of naam gebruiken)
vader en moederouders, verzorgers
man/vrouw (als niet relevant)persoon, bewoner, aanvrager
gehandicaptepersoon met een beperking
allochtoon/autochtoon(specificeer: Amsterdammer met Turkse achtergrond)
laagopgeleidpraktisch opgeleid
daklozepersoon zonder vaste woonplek

Uitgebreide richtlijnen -> references/inclusief-taalgebruik.md

Leestekens

Gebruik
  • Punt — alleen na volledige zinnen. Niet na titels, koppen of losse woorden.
  • Vraagteken — alleen als je de lezer echt een vraag stelt die die zelf kan beantwoorden.
  • Komma — spaarzaam. Vaak teken van een te lange zin.
  • Aanhalingstekens — enkelvoudig bij eigennamen of jargon dat je uitlegt. Dubbel bij citaten.
  • Uitroepteken — zeer spaarzaam, komt belerend over. Alleen bij echte uitroep of heftige emotie.
Verboden leestekens

Gebruik nooit:

  • Haakjes
  • Puntkomma
  • Gedachtenstreepjes
  • Sterretje (asterisk)
  • Superscript
  • Ampersand (&)
  • Procentteken (%)

Contextdetectie

Pas het register automatisch aan op basis van wat er geschreven wordt:

SignaalModusRegisterWoordlimiet
UI-tekst, button, label, foutmeldingUIu, ultra-kort1-2 zinnen
Webpagina, informatietekstWebcontentu, B1max 500 woorden
Webartikel, nieuwsberichtWebartikelu, B1, scanbaarmax 300 woorden
Brief, beschikkingBriefu, B1, formeelmax 2 A4
E-mail aan burgerE-mailu, B1, bondigmax 150 woorden
Beleidstekst, raadsstukBeleidu, B1-B2, zakelijkzo kort mogelijk
Eenvoudige taal / laaggeletterdEenvoudigu, A2max 200 woorden
Interne memo, SlackInternje, informeelgeen limiet
Chatbot, conversationalChatbotje, B1, kortmax 3 zinnen
Social mediaSocialje, casualplatformafhankelijk
Juridische tekstJuridischu, B1, correctgeen limiet

Sjablonen per tekstsoort -> references/tekstsoorten.md A2-niveau uitleg -> references/eenvoudige-taal.md

Opmaak: snelreferentie

Getallen en valuta

Getallen schrijven we altijd in cijfers. Alle getallen, ook kleine.

TypeRegelVoorbeeld
Alle getallenAltijd cijfers2 collega's, 7 dagen, 3 parkeerplaatsen
RangtelwoordenVoluit in letterseerste, tweede, derde (uitzondering: 17de eeuw)
BedragenEuroteken + cijfersEUR 198,50 of EUR 1.000,-
Grote bedragenPunt als duizendtekenEUR 1.250.000,-
DecimalenKomma3,5
ProcentenWoord "procent" voluit75 procent (nooit %)
BreukenIn lettersdrie vijfde, of: 3 van elke 5
Miljoen/miljardVoluit, nooit afkorten17 miljoen inwoners (niet: 17 mln)
Romeinse cijfersNiet gebruikenGebruik gewone cijfers
Zin beginnenNooit met een cijferHerformuleer de zin
Datums en tijden
TypeRegelVoorbeeld
Datum voluitdag maand jaar15 maart 2026
Datum kortdd-mm-jjjj15-03-2026
Tijd24-uursnotatie14.30 uur
Periodetot en met1 tot en met 15 maart
Telefoonnummers en adressen
TypeRegelVoorbeeld
Gemeente Amsterdam14 020Bel 14 020
Mobiel06 1234 5678--
Vast020 123 4567--
AdresStraatnaam huisnummerAmstel 1, 1011 PN Amsterdam
URLZonder https://amsterdam.nl/parkeren
Opsommingen
  • Gebruik vierkante opsommingstekens (huisstijl)
  • Hele zinnen: hoofdletter + punt achter elk item
  • Losse woorden/woordgroepen: kleine letter, geen punt
  • Genummerde lijst alleen als: (1) de voorafgaande tekst een aantal noemt, of (2) er een vaste volgorde is
  • Elk item in de opsomming moet dezelfde grammaticale structuur hebben
Opmaakregels
  • Uitlijning: altijd links. Nooit uitvullen, centreren of rechts.
  • Lettertype: Corbel, grootte 10,5 in Word.
  • Regelafstand: "ten minste" 14 pt.
  • Cursief: liever niet. Gebruik context of enkele aanhalingstekens. Online niet toegankelijk.
  • Vet/onderstreept: spaarzaam. Te veel verliest kracht. Onderstreept kan verward worden met link.
Afkortingen
  • Schrijf afkortingen de eerste keer voluit: "Basisregistratie Personen (BRP)"
  • Gebruik daarna de afkorting: "de BRP"
  • Bekende afkortingen hoeven niet voluit: AOW, WOZ, btw, OV

Wetteksten

Zet nooit wetteksten of wetsartikelen in de lopende tekst. Plaats alle juridische verwijzingen in een apart blok "Geldende wet- en regelgeving" onderaan de tekst, voor de ondertekening. Zo blijft de tekst leesbaar en juridisch houdbaar.

Juridisch schrijven -> references/tekstsoorten.md (sectie Juridische tekst) Juridisch woordenboek -> references/juridisch-woordenboek.md

FAQ-pagina's

Maak geen FAQ-pagina's (veelgestelde vragen) op het web. Gebruik ook geen vraag-en-antwoord-structuur in webteksten. Dit voldoet niet aan de toegankelijkheidseisen en is problematisch voor lezers met een lagere taalvaardigheid.

Veelgemaakte fouten

FoutVoorbeeldVerbetering
Passieve zinUw aanvraag wordt beoordeeld.Wij beoordelen uw aanvraag.
Organisatie-centraalDe gemeente heeft besloten...U krijgt... omdat...
JargonConform artikel 4:5 Awb...Volgens de wet moet u...
Negatief formulerenU kunt niet bellen na 17.00 uur.Bel ons op werkdagen tussen 8.00 en 17.00 uur.
Te lange zinWe willen u informeren dat naar aanleiding van uw verzoek dat u op 3 januari heeft ingediend een besluit is genomen.U heeft op 3 januari een verzoek ingediend. Wij hebben hierover een besluit genomen.
VaagU hoort binnenkort van ons.U ontvangt voor 1 april een brief.
AfkortingenUw WWB-uitkering via de GBAUw bijstandsuitkering (WWB) via de Basisregistratie Personen (BRP)
NominalisatieNa beoordeling van de aanvraagNadat wij uw aanvraag hebben beoordeeld
TangconstructieHet door u ingediende en door ons beoordeelde verzoekUw verzoek dat wij hebben beoordeeld
Procentteken12% van de bewoners12 procent van de bewoners
Getallen voluitdrie parkeerplaatsen3 parkeerplaatsen

Integratie met Design System

Deze skill bepaalt de tekstinhoud binnen Amsterdam Design System-componenten. De amsterdam-design-system skill bepaalt HOE dingen eruitzien; deze skill bepaalt WAT er staat.

ComponentTekstadvies
ButtonMax 3 woorden, actief werkwoord: "Vraag aan", "Bekijk resultaat"
AlertEerste zin = wat is er aan de hand. Tweede zin = wat kan de lezer doen.
ErrorMessageWat ging er mis + wat nu te doen: "Vul uw postcode in (bijv. 1011 AB)"
LabelKort, duidelijk, geen dubbele punt: "Postcode", "E-mailadres"
HeadingInformatief, max 5 woorden, geen werkwoord-zin
ParagraphOngeveer 5 regels / 75 woorden, kernzin eerst
LinkBeschrijvend, nooit "klik hier": "Bekijk de voorwaarden"
Tooltip / DescriptionEen zin, geeft extra context

Referentiebestanden

BestandInhoud
references/woordenlijst.mdVerboden woorden en alternatieven, per categorie
references/voorbeelden.mdVolledige voor/na-voorbeelden per tekstsoort
references/eenvoudige-taal.mdA2-niveau schrijfregels voor laaggeletterden
references/inclusief-taalgebruik.mdUitgebreide richtlijnen inclusieve taal
references/tekstsoorten.mdSjablonen en structuur per tekstsoort
references/hoofdletters.mdHoofdletterregels voor gemeente, functies, wetten, etc.
references/juridisch-woordenboek.mdJuridisch jargon vertaald naar heldere taal

Comments

Markdown supported