skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
amsterdam/amsterdam-agent-skills152 installs

amsterdam-stijl

Mandatory for Gemeente Amsterdam Dutch text and tone of voice. Use for UI labels, buttons, headings, error messages, form labels, page content, notifications, descriptions, tooltips, placeholder text, web content, letters, emails, policy documents, chatbot responses, and other user-facing writing. Covers De Stijl van Amsterdam, Heldere Taal (B1), Eenvoudige Taal (A2), inclusive language, active writing, and Amsterdam tone. Use with amsterdam-design-system when UI work includes text.

How do I install this agent skill?

npx skills add https://github.com/amsterdam/amsterdam-agent-skills --skill amsterdam-stijl
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill provides writing and style guidelines for the Municipality of Amsterdam. It contains no code, dependencies, or security risks.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • ZeroLeakspass

    Score: 93/100 · 2 sections analyzed

What does this agent skill do?

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 info@amsterdam.nl.
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

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/amsterdam/amsterdam-agent-skills/amsterdam-stijl">View amsterdam-stijl on skillZs</a>