navikt Klarspråk
OpenCode v1: Skill names below are exact IDs from the active catalog, not slash commands. Load them with the native
skilltool. Slash commands are direct user entry points only.
Stram inn norsk prosa uten å endre beslutninger, kontrakter eller teknisk betydning.
Oppdag språkreglene først
Ikke anta at hele repositoryet bruker samme språk.
- Finn consumer-eide språkregler for den konkrete artefakttypen og pathen.
- Identifiser målgruppe, bokmål/nynorsk, tone og regler for domeneord, tekniske termer, kodeidentifikatorer og logger.
- Behandle eksisterende tekst som evidens bare når den er konsekvent; tilfeldig historikk er ikke automatisk en standard.
- Hvis en nødvendig språkregel mangler, spør brukeren. Ikke innfør en generell norsk/engelsk-policy gjennom en språkvask.
Bevar literals, API-felter, identifikatorer og etablerte domenetermer nøyaktig når en endring ville endre kontrakten.
Arbeidsflyt
- Avklar om oppgaven er ren språkvask eller også innholdsredigering.
- Marker fakta, beslutninger, normative krav og kodeord som ikke skal endres.
- Skriv om med kortere setninger, aktive verb og tydelig handling.
- Kontroller at tall, modalverb, negasjoner, vilkår og ansvar fortsatt betyr det samme.
- Vis vesentlige meningsnære valg hvis flere formuleringer er mulige.
Operative regler
- Start med utfallet eller handlingen leseren trenger.
- Hold ett hovedpoeng per setning.
- Bruk aktiv form og konkrete subjekter.
- Kutt gjentakelser, fyllord og kunstige oppsummeringer.
- Bruk tekniske termer etter consumerens policy. Hvis ingen policy finnes, spør før du oversetter eller fornorsker etablerte termer.
- Bruk bindestrek i norske sammensetninger med engelske fagtermer når det er naturlig.
- Fjern svulstige AI-markører og falsk symmetri uten å gjøre teksten monoton.
- Bruk Nav i løpende tekst når virksomheten omtales; bevar offisielle navn og kodeidentifikatorer som de er.
- Ikke ta med personopplysninger, tokens eller secrets i brukerrettede feilmeldinger eller eksempler.
Grenser
Alltid
- Bevar teknisk betydning og dokumentert artefaktform.
- Skill språklige forslag fra innholdsendringer.
- Følg den mest spesifikke consumer-eide språkregelen.
Spør først
- Omstrukturere et helt dokument.
- Endre terminologi som inngår i domene- eller API-kontrakter.
- Publisere, kommentere eksternt eller opprette PR/issue; vis mål og få eksplisitt godkjenning.
Aldri
- Gjette målform, språkvariant eller loggspråk.
- Endre en beslutning under dekke av språkvask.
- Erstatte et kodeord eller domeneterm bare fordi et norsk synonym finnes.