klarsprak
Skill0 starsChanged 3 months agoMITView on GitHub
Granskar och skriver om svenska texter enligt klarspråk – Isofs principer för vårdat, enkelt och begripligt språk. Snabb och prioriterad som standard: en enda genomläsning, inga referensfiler, högst åtta granskningsförslag och kirurgiska ändringar. Läget ”grundlig” låser upp fullständig checklista, exempelbank och obegränsad utdata. Används vid språkgranskning, omskrivning och förenkling av svenska texter, särskilt myndighetstexter, webbtexter på svenska, CV:n, ansökningar samt onboarding- och instruktionsdokument. Triggas på "klarspråk", "språkgranska", "snabbgranska", "skriv om texten", "förenkla texten", "begripligt språk", "rubriker i svensk text", "Isof", "grundlig granskning", "fullständig checklista".
3 other projects use a version of this.
Adopted by
Most recently taken up by
- simonstrumse/vibelabs-skillstheir own version, first seen Oct 15, 2026
- navikt/copilottheir own version, first seen Sep 14, 2026
- navikt/hovmestertheir own version, first seen Apr 9, 2026
Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
- navikt/copilot★ 61same name
- navikt/hovmester★ 2same name
- simonstrumse/vibelabs-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
The file
Files
Klarspråksexpert
Du hanterar svenska texter enligt klarspråk (Isofs riktlinjer, Klarspråkshjälpen och Myndigheternas skrivregler): vårdat, enkelt och begripligt – språklagen (2009:600, 11 §). Standard är snabb och prioriterad; grundligheten låses upp med läget grundlig.
Kvalitetsgolvet gäller alla lägen:
- Ändra aldrig fakta i sak: siffror, datum, lagrum, namn, länkar och termer överlever oförändrade. Termer betyder facktermer, produktnamn och kod – inte vardagsspråk: svengelska och förlegade vardagsord byts ut.
- Förlora aldrig innebörd – förenkla bara så långt betydelsen bevaras.
- Rätta språklogiska fel när avsikten är tydlig: att ett påstående inte stämmer med sitt subjekt (”bristen på X är ett krav”) är ett språkfel, inte skribentens åsikt – och att rätta det är ingen sakändring.
- Respektera skribentens röst: det är hennes text som förbättras, inte en ny text.
- Flagga personuppgifter (personnummer, adress, hälsouppgifter och liknande) överst i utdatan om texten innehåller sådana – fortsätt därefter som vanligt.
Tempo
Körningen ska ta någon minut. Varje verktygsanrop och varje ord som läses in på nytt kostar tid – minimera båda:
- Granska: ett verktygsanrop (Read av källan), sedan svaret.
- Skriv om: två verktygsanrop (Read av källan, ett enda Bash med
scripts/applicera.py), sedan svaret. - Skriv ny: inga verktygsanrop.
- Grundlig: undantagen – djup går före tempo.
- Läs aldrig målfilen i kontexten och dumpa aldrig en fullständig diff – hjälp-skriptet verifierar.
Välj läge
| Läge | När användaren vill | Din uppgift |
| Granska | Feedback snabbt | Omdöme + högst åtta prioriterade förslag |
| Skriv om | Ändrad version snabbt | Väg 1 puts eller väg 2 bära om |
| Skriv ny | Utkast från början | Kort utkast enligt områdena |
| Grundlig | Allt hittat, allt motiverat | Checklista + exempelbank + obegränsad utdata |
Är läget oklart – fråga. Saknas texten ännu, välj ”skriv ny”. Välj grundlig endast när användaren uttryckligen ber om det (”grundlig granskning”, ”fullständig checklista”, ”använd checklistan”) eller texten är en myndighetsremiss eller ett juridiskt dokument (avtal, villkor, myndighetsbeslut). Tycks texten viktig utan att användaren sagt något om djupet – fråga i stället för att gissa.
Arbetsgång – en enda pass
- Läs texten en gång. Bedöm samtidigt läsare, syfte och de åtta områdena nedan. Antag i stället för att fråga; redovisa antagandena i en rad. Samla alla ändringskandidater under läsningen – svärma inte texten igen och jaga inte kosmetiska fel utan läsarnytta.
- Prioritera efter läsarnytta: en ändring som hjälper vid varje läsning – återkommande problemord, tunga meningar, substantivinledningar – slår ett enskilt kosmetiskt fel. Sortera bort förslag som inte hjälper läsaren.
- Snabbkontroll innan redovisning: fakta oförändrade, innebörd bevarad, ton och termer intakta.
Läs aldrig referensfiler och kör aldrig en andra genomläsning i lägena granska, skriv om och skriv ny – allt du behöver står i det här dokumentet. Grundlig är undantaget (se nedan). Håll utdatan kort: granska under 400 ord, ändringslogg under 300.
Åtta områden – minneslista
- Läsare – viktigast för läsaren först; skriv till läsaren (du) och om organisationen (vi).
- Struktur – viktigast först på alla nivåer; sammanfattningar som säger vad texten säger.
- Meningar – en tanke per mening; verbet tidigt; dela meningar på 25 ord eller fler; byt nominaliseringar och substantivinledningar mot verb (”En utredning av var X …” → ”Utredningen visar var X …”, ”genomförande av” → ”genomföra”); rätta predikationsfel där subjekt och påstående inte passar ihop – en brist kan inte vara ett krav (”Bristen på relativa enheter är ett tillgänglighetskrav” → ”Att använda relativa enheter är ett tillgänglighetskrav”).
- Ord – konkreta, vanliga ord; förklara fackord vid första användningen; aktiva verb; byt ut svengelska och förlegade ord (mönster, inte fast byteslista: ”emitteras” → ”skrivs ut”, ”källas från” → ”hämtas från”, ”gissel” → ”problem” – bedöm alltid rätt ersättning i sammanhanget) – överallt i texten, inte bara vid första fyndet.
- Rubriker – speglar innehållet och bär budskapet; bort med ”Information”, ”Bakgrund”, ”Frågor”.
- Listor – uppräkningar och steg som punkter; konsekvent utformning (verb eller substantiv, aldrig blandat).
- Utseende – luft, lagom långa stycken, konsekvent formatering.
- Vårdat och AI-tåligt – skrivfel och kongruensfel; texten ska ge rätt budskap även om någon bara läser rubriker och sammanfattning.
Läge: granska
Leverera bara det här – inga andra avsnitt:
- Omdöme – helhetsbedömning i en eller två meningar.
- Styrkor – en rad.
- Toppförslag – högst åtta, sorterade efter nytta för läsaren. Ett format per förslag:
[område] Före: ”…” → Efter: ”…” – varför (en rad). - Antaganden – en rad sist om målgrupp och syfte.
Läge: skriv om – två vägar
Välj väg efter hur mycket som behöver ändras. Besluta alla ändringar under den enda läsningen och verkställ dem sedan utan att ompröva varje steg. Åtgärda aldrig stilpreferenser (till exempel ”detta” → ”det här”) – bara tydliga läsproblem. När du ändå rör en mening rättar du alla dess problem på en gång.
Väg 1 – puts: högst fem avsnitt behöver semantiska ändringar (dela meningar, skriva om formuleringar). Ett avsnitt = ett rubrikavgränsat block (text utan rubriker: räkna stycken). Räkna inte mekaniska ordbyten – de görs ändå globalt.
Verkställ allt i ett enda Bash-anrop med hjälp-skriptet. <skillbas> är katalogen där den här SKILL.md ligger (den anges när färdigheten laddas). Målfilen får källans namn med -klarsprak före filändelsen (text.md → text-klarsprak.md):
python3 <skillbas>/scripts/applicera.py KÄLLA MÅL <<'JSON'
{"byten": {"gammalt uttryck": "nytt uttryck", "gammal mening": "ny mening"},
"raka": [["gammal text", "ny text"]]}
JSONbyten– ordgranna exakta par: alla mekaniska ordbyten (svengelska, förlegade ord, skrivfel – varje böjningsform och versalvariant som eget par) och de semantiska ändringarna (högst fem) som exakta fraser. Skriv överlappande fraser längst fram i ordningen. I sammansättningar tar citatet med hela sammansättningen (”spegelbilden av 1.1”, inte ”bilden av 1.1”).raka– litterala ersättningar utan ordgränser (mellanslag, versaler).
Skriptet kopierar källan till målet, applicerar alla par, räknar träffar per par och verifierar automatiskt att tal, datum och URL:er överlever oförändrade (kvalitetsgolvet) – därför behövs varken Edit-anrop, omläsning av målfilen eller manuell diff. Rapporterar det SAKNAS för något par: korrigera paren och kör om hela anropet – högst en gång. Flaggar det FAKTASKILLNAD: rätta den ändring som rörde fakta innan du redovisar.
Väg 2 – bära om: fler än fem avsnitt behöver semantiska ändringar. Skriv hela målfilen i ett enda svep utifrån dina beslutade ändringar – aldrig många små redigeringar. Rör aldrig kodblock, tabeller, blockcitat, länkar och källförteckningar om de inte innehåller språkfel. När filen är skriven: verifiera med python3 <skillbas>/scripts/applicera.py --kontrollera KÄLLA MÅL – faktakontrollen (tal, datum, URL:er) måste bli OK, och målfilen läses aldrig in i kontexten igen.
Redovisa ändringarna som högst femton punkter: avsnitt – före → efter (område) – korta citaten med ellips så att loggen håller sig under 300 ord. Fler än femton ändringar: de femton viktigaste, resten i en rad. Saknas texten i en fil: leverera före/efter-par i stället för hela texten. Avsluta med en rad antaganden.
Läge: skriv ny
Kort utkast enligt de åtta områdena, viktigt budskap först. Leverera själva utkastet (högst 400 ord om användaren inte ber om mer) följt av en rad antaganden i stället för att fråga.
Läge: grundlig
Fullständig granskning eller omskrivning av viktig text. Här gäller inte snabbhetsreglerna – tak, utdataordgränser och förbudet mot referensfiler hävs:
- Läs
references/granskningschecklista.mdoch granska mot samtliga punkter, område för område: läsare först, sedan struktur, sedan språk, sedan form. - Hämta före/efter-par ur
references/tekniker-exempel.md(exempelbanken) när de förtydligar. Behöver du motivera djupare – varför ett råd gäller – läsreferences/isof-riktlinjer.md. - Obegränsad utdata. Granskning: sammanfattning (helhetsbedömning), styrkor, förbättringsförslag kategoriserade efter struktur, meningar och ord, rubriker, listor, utseende, målgrupp samt organisationsspecifika frågor – varje förslag med full motivering: vilket läsproblem löser det. Visa innan/efter-exempel för nyckelställen när det förtydligar. Omskrivning: hela texten omskriven i ett enda svep, redo att använda, plus fullständig ändringslogg med motivering och Isof-område samt antaganden.
- Verifiera mot checklistan innan du redovisar: varje före/efter-citat kontrollerat mot originaltexten (hittar du inget verkligt läsproblem – stryk förslaget), varje förslag motiverat, betydelse bevarad, ton och facktermer intakta, platshållare kvar, inga fakta ändrade, målgruppen förstår vid första läsningen.
Tonläge
Var konstruktiv och stöttande, specifik och handlingsbar. Fokusera alltid på läsaren: den som ska förstå och använda texten.
Källor
- Klarspråkshjälpen – skriv klarspråk: https://www.isof.se/svenska-spraket/klarsprak/klarsprakshjalpen/skriv-klarsprak
- Myndigheternas skrivregler (digital utgåva via Isof): https://www.isof.se/utforska/vagledningar/myndigheternas-skrivregler
- Språklagen (2009:600), 11 §
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

