diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index ddeed3d..30def55 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -42,6 +42,11 @@ "name": "einfaches-technisches-deutsch", "source": "./plugins/einfaches-technisches-deutsch", "description": "Antworten in einfachem technischem Deutsch (nach ASD-STE100, ins Deutsche übertragen): Aktiv, kurze Sätze, ein Gedanke pro Satz — Technik bleibt exakt." + }, + { + "name": "klare-sprache", + "source": "./plugins/klare-sprache", + "description": "Texte in klarer, verständlicher Sprache nach ISO 24495-1:2023 (Plain Language): zielgruppenorientiert — finden, verstehen, nutzen." } ] } diff --git a/plugins/klare-sprache/.claude-plugin/plugin.json b/plugins/klare-sprache/.claude-plugin/plugin.json new file mode 100644 index 0000000..7158a20 --- /dev/null +++ b/plugins/klare-sprache/.claude-plugin/plugin.json @@ -0,0 +1,8 @@ +{ + "name": "klare-sprache", + "version": "0.1.0", + "description": "Texte in klarer, verständlicher Sprache nach ISO 24495-1:2023 (Plain Language) schreiben oder überarbeiten: zielgruppen- und prozessorientiert — finden, verstehen, nutzen.", + "author": { + "name": "inmedias.it" + } +} diff --git a/plugins/klare-sprache/skills/klare-sprache/SKILL.md b/plugins/klare-sprache/skills/klare-sprache/SKILL.md new file mode 100644 index 0000000..bf69a22 --- /dev/null +++ b/plugins/klare-sprache/skills/klare-sprache/SKILL.md @@ -0,0 +1,76 @@ +--- +name: klare-sprache +description: Texte in klarer, verständlicher Sprache nach ISO 24495-1:2023 (Plain Language) schreiben oder überarbeiten. Use when the user asks for clear/plain/accessible language, mentions "klare Sprache", "verständlich schreiben", "plain language", "ISO 24495", "bürgernah", "leicht verständlich", "an die Zielgruppe anpassen", or wants a text a specific audience can easily find, understand, and use. +version: 0.1.0 +--- + +# Klare Sprache (ISO 24495-1:2023) + +Dieser Skill schreibt und überarbeitet Texte nach den Leitprinzipien der +ISO 24495-1:2023 („Plain language — Part 1"). Ziel: Die vorgesehenen Leser +finden leicht, was sie brauchen, verstehen es und können danach handeln. + +Anders als starre Regelwerke (Wortlisten, feste Satzlängen) ist ISO 24495-1 +**prinzipien- und prozessorientiert**. Der Maßstab ist nicht „einfach an sich", +sondern **passend für die konkrete Zielgruppe und ihren Zweck**. + +## Wann anwenden + +Wende den Skill an, wenn der Nutzer einen Text verständlich für eine bestimmte +Zielgruppe braucht (Kunden-Doku, Anleitungen, Formulare, Briefe, Web-Texte, +Bescheide). Für einen festen, normierten Schreibstil in der internen Technik- +Doku passt eher [[einfaches-technisches-deutsch]]. + +## Kerndefinition + +Ein Text ist in klarer Sprache, wenn Wortwahl, Struktur und Gestaltung so klar +sind, dass die vorgesehenen Leser leicht + +1. **finden**, was sie brauchen, +2. **verstehen**, was sie finden, und +3. **nutzen** können, was sie verstanden haben. + +## Ablauf + +1. **Zielgruppe und Zweck klären.** Wer liest? Welches Vorwissen? Was soll die + Person danach wissen oder tun? Ist das unklar, frage kurz nach — ohne + Zielgruppe lässt sich „klar" nicht beurteilen. +2. **Schreiben/Überarbeiten** nach den vier Prinzipien (unten). +3. **Prüfen** gegen die Checkliste; wenn möglich, aus Lesersicht gegenlesen. +4. **Kurz zurückmelden**, welche Zielgruppe angenommen wurde und was geändert + wurde. + +## Die vier Prinzipien mit Checkliste + +### 1. Relevant — Leser bekommen, was sie brauchen +- Inhalt an Zielgruppe und Zweck ausrichten. +- Vorwissen und Bedarf der Leser berücksichtigen. +- Unnötiges weglassen; das Wichtigste zuerst. + +### 2. Auffindbar — Leser finden es leicht +- Logische, erwartbare Reihenfolge. +- Aussagekräftige Überschriften und Zwischenüberschriften. +- Gliederung, Listen, Hervorhebungen; klares Layout und Navigation. + +### 3. Verständlich — Leser verstehen es beim ersten Lesen +- Gebräuchliche Wörter; Fachbegriffe und Abkürzungen erklären oder ersetzen. +- Kurze, klar gebaute Sätze; ein Gedanke pro Satz. +- Aktiv statt Passiv; die Leser direkt ansprechen. +- Beispiele, wo sie helfen. + +### 4. Nutzbar — Leser können danach handeln +- Handlungsschritte klar und in der richtigen Reihenfolge. +- Sagen, wer was tun muss. +- Den Text an einer echten Aufgabe prüfen und überarbeiten. + +## Technische Angaben bleiben exakt + +Klarheit betrifft die Sprache, nicht die Fakten. Dateipfade, Befehle, +Funktions- und Feldnamen, Preise, Zahlen und Fristen bleiben unverändert. + +## Grenzen + +- Der Skill setzt die **Prinzipien** der Norm um; er gibt nicht den geschützten + Normtext wieder und bescheinigt keine formale Konformität. +- Gilt für Fließtext und Struktur, nicht für Code, Log-Ausgaben oder Zitate. +- Ohne bekannte Zielgruppe zuerst nachfragen.