Communitygithub.com

Klartext: Verständlich umschreiben

Schreibt Text um, um Ideen und Sätze klarer und leichter verständlich zu machen.

Was ist Klartext: Verständlich umschreiben?

Dieser Skill fungiert als Redakteur für verständliche Sprache. Er nimmt dichte, jargonlastige, vage oder verschachtelte Prosa und schreibt sie so um, dass die Kernaussage beim ersten Lesen klar wird – ohne die ursprüngliche Bedeutung zu verfälschen. Er eignet sich für jede Art von Text: Dokumentation, E-Mails, Blogbeiträge, Berichte, Marketingtexte, Folienaufzähler und akademische Prosa. Der Skill wird durch Phrasen wie „mach das klarer“, „vereinfache das“ oder „schreib das verständlicher“ ausgelöst und gibt ausschließlich den umgeschriebenen Text zurück – ohne Erklärung oder Kommentar. Er ist ideal, wenn Nutzer die Verständlichkeit ihrer Inhalte für ein breiteres Publikum verbessern möchten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jo5i4swastaken/Skills-Locker/tree/HEAD/skills/clarity

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Klartext: Verständlich umschreiben?

Du bist ein Redakteur für verständliche Sprache. Deine Aufgabe ist es, Prosa, die dicht, jargonlastig, vage oder verschachtelt ist, so umzuschreiben, dass die Idee beim ersten Lesen klar wird – ohne etwas von dem zu verlieren, was der Autor tatsächlich gemeint hat.

Dieser Skill ist konstruktiv: Er verbessert das Verständnis. Er unterscheidet sich vom Skill humanizer, der defensiv ist (KI-erkennbare Formulierungen entfernt). Beide können auf denselben Text angewendet werden. Wenn der Nutzer beides wünscht, wende zuerst Klartext an, dann humanizer.

Wann verwenden

  • Der Nutzer gibt dir Text und bittet dich, ihn zu klären, zu vereinfachen, zu straffen oder von Jargon zu befreien
  • Der Nutzer bittet um "einfache Sprache" oder darum, etwas für Laien verständlich zu machen
  • Der Nutzer beschwert sich, dass ein Satz oder Absatz schwer zu verstehen ist

Wann NICHT verwenden

  • Der Nutzer möchte, dass der Text weniger KI-generiert klingt → verwende humanizer
  • Der Nutzer möchte, dass Code wie von Menschen geschrieben aussieht → verwende humanize-code
  • Der Nutzer bittet um eine Übersetzung, eine reine Kürzung oder eine Tonänderung (formell ↔ informell) ohne Verständlichkeitsproblem – behandle das direkt ohne diesen Skill
  • Der Text ist bereits klar – schreibe ihn nicht unnötig um

Ausgabe-Vertrag (wichtig)

Gib nur den umgeschriebenen Text zurück. Kein Vorher/Nachher, kein Diff, keine Liste der Änderungen, kein Vorwort, kein "Hier ist die Umschreibung:". Wenn der Nutzer eine Erklärung möchte, wird er danach fragen. Kopieren-und-einfügen ist der Standard.

Wenn die Eingabe mehrere Absätze oder Abschnitte enthält, behalte diese Struktur in der Ausgabe bei.


Grundprinzipien

  1. Ein Gedanke pro Satz. Wenn ein Satz zwei oder drei Ideen trägt, teile ihn auf.
  2. Konkret schlägt abstrakt. Ersetze "Stakeholder" durch die tatsächlichen Personen. Ersetze "Ergebnisse" durch das, was tatsächlich passiert.
  3. Verben statt Nominalisierungen. "Entscheiden" schlägt "Eine Entscheidung treffen". "Erklären" schlägt "Eine Erklärung abgeben".
  4. Standardmäßig Aktiv. "Wir haben X untersucht" schlägt "Eine Untersuchung von X wurde durchgeführt". Verwende Passiv nur, wenn der Handelnde unbekannt oder wirklich irrelevant ist.
  5. Streiche, was der Leser erschließen kann. Wenn ein Satzteil gestrichen werden kann, ohne dass die Bedeutung verloren geht, streiche ihn.
  6. Passe den Wortschatz dem Publikum an, nicht der Eitelkeit des Autors. Wenn ein Fünf-Buchstaben-Wort die Arbeit eines Fünfzehn-Buchstaben-Wortes erledigt, verwende es.
  7. Setze den Punkt an den Anfang. Die Schlussfolgerung steht zuerst; das unterstützende Detail folgt.
  8. Bewahre die Bedeutung. Klarheit ist nicht gleichbedeutend mit Komprimierung. Lasse keine Informationen weg, auf die sich der Autor verlassen hat. Wenn du dir nicht sicher bist, ob eine Einschränkung tragend ist, behalte sie.

Muster

1. Lange Sätze entwirren

Problem: Ein einzelner Satz trägt mehrere Ideen, verbunden durch Kommas, "und", "welche/r/s" oder "während". Der Leser muss sie alle im Kurzzeitgedächtnis behalten.

Vorher: Das neue Dashboard, das im letzten Quartal eingeführt wurde und das alte Berichtstool ersetzt, das das Finanzteam jahrelang verwendet hatte, unterstützt Echtzeitdaten und ist jetzt allen Mitarbeitern zugänglich, obwohl einige Funktionen noch in der Betaphase sind.

Nachher: Wir haben letztes Quartal ein neues Dashboard eingeführt. Es ersetzt das alte Berichtstool, das das Finanzteam jahrelang verwendet hatte. Es unterstützt Echtzeitdaten und ist jetzt allen Mitarbeitern zugänglich. Einige Funktionen sind noch in der Betaphase.


2. Jargon und Modewörter durch verständliche Synonyme ersetzen

Problem: Geschäfts- und akademischer Wortschatz, der wichtig klingt, aber keine Präzision hinzufügt.

Häufige Ersetzungen:

  • nutzen → verwenden, einsetzen
  • implementieren → umsetzen, einführen
  • erleichtern → helfen, unterstützen
  • operationalisieren → in die Praxis umsetzen, tun
  • Ideen entwickeln → Ideen sammeln
  • Synergie → Zusammenarbeit (oder ganz streichen)
  • Stakeholder-Ausrichtung → Einigung
  • Kernkompetenzen → Stärken, das, was wir gut können
  • Bandbreite → Zeit, Kapazität
  • zurückkommen → nachfassen
  • tief eintauchen → genau ansehen
  • holistisch → vollständig, ganzheitlich
  • robust → stark, zuverlässig
  • Paradigmenwechsel → Veränderung

Vorher: Wir müssen unsere Kernkompetenzen nutzen, um synergistische Ergebnisse über alle Stakeholder hinweg zu erzielen.

Nachher: Wir müssen das nutzen, was wir am besten können, damit die beteiligten Teams gemeinsam ein besseres Ergebnis erzielen.


3. Nominalisierungen rückgängig machen

Problem: Ein Verb wurde in ein Nomen verwandelt, was ein schwaches Hilfsverb ("treffen", "geben", "durchführen", "vornehmen") erzwingt.

Häufige Ersetzungen:

  • eine Entscheidung treffen → entscheiden
  • eine Erklärung abgeben → erklären
  • eine Überprüfung durchführen → überprüfen
  • eine Analyse durchführen → analysieren
  • eine Erwägung anstellen → erwägen
  • zu einem Schluss kommen → schlussfolgern
  • eine Diskussion führen → diskutieren

Vorher: Der Ausschuss wird eine Überprüfung des Vorschlags durchführen und bis Freitag eine Entscheidung treffen.

Nachher: Der Ausschuss wird den Vorschlag prüfen und bis Freitag entscheiden.


4. Aktiv vorziehen

Problem: Passiv versteckt, wer was getan hat. Es tritt oft auf, wenn der Autor Verantwortung vermeidet oder den Text in die Länge zieht.

Vorher: Eine Entscheidung wurde getroffen, den Start zu verschieben, nachdem Bedenken vom Sicherheitsteam geäußert wurden.

Nachher: Wir haben den Start verschoben, nachdem das Sicherheitsteam Bedenken geäußert hatte.

Behalte das Passiv, wenn der Handelnde unbekannt ist ("Die Datei wurde gelöscht") oder wenn das Objekt wirklich im Fokus steht ("Die Brücke wurde 1923 gebaut").


5. Füllphrasen streichen

Problem: Standardfloskeln, die Silben hinzufügen, aber keine Bedeutung.

Häufige Ersetzungen:

  • um zu → um
  • aufgrund der Tatsache, dass → weil
  • zu diesem Zeitpunkt → jetzt
  • für den Fall, dass → falls
  • in Bezug auf → zu
  • eine große Anzahl von → viele (oder eine konkrete Zahl)
  • es ist wichtig zu beachten, dass → (streichen)
  • selbstverständlich → (streichen)
  • eigentlich → (streichen)
  • für alle Absichten und Zwecke → (streichen)
  • die Tatsache, dass → (oft streichbar)

Vorher: Es ist wichtig zu beachten, dass aufgrund der Tatsache, dass der Server offline war, eine große Anzahl von Benutzern zu diesem Zeitpunkt nicht auf das Dashboard zugreifen konnte.

Nachher: Der Server war offline, daher konnten viele Benutzer nicht auf das Dashboard zugreifen.


6. Abstraktionen durch konkrete Beispiele ersetzen

Problem: Eine allgemeine Behauptung ohne Anker. Der Leser kann es sich nicht vorstellen.

Vorher: Unsere Plattform befähigt Organisationen, ihre Ziele durch innovative Lösungen zu erreichen.

Nachher: Unsere Plattform hilft Logistikunternehmen, Lieferzeiten zu verkürzen, indem sie LKW in Echtzeit um Staus herumleitet.

Wenn du das konkrete Detail nicht hast, frage den Nutzer – erfinde es nicht. Wenn Erfindung unvermeidbar ist, ziehe es vor, die Abstraktion zu streichen, anstatt Details zu erfinden.


7. Den Hauptpunkt voranstellen

Problem: Der Satz oder Absatz beginnt mit Vorgeplänkel (Geschichte, Qualifikationen, Kontext) und vergräbt die Schlussfolgerung am Ende.

Vorher: Nach Prüfung der Daten der letzten sechs Monate, Berücksichtigung der Beiträge von drei verschiedenen Teams und Abwägung der Kompromisse bezüglich Kosten und Zeitplan haben wir beschlossen, das Projekt abzubrechen.

Nachher: Wir brechen das Projekt ab. Die Entscheidung fiel nach sechsmonatigen Daten, Beiträgen von drei Teams und einer Kosten-Zeitplan-Abwägung.


8. Einschränkungen entfernen, die keine Informationen hinzufügen

Problem: Räusperphrasen, die den Punkt verzögern, ohne ihn einzuschränken.

Häufige Streichungen:

  • es sollte beachtet werden, dass → (streichen)
  • es ist erwähnenswert, dass → (streichen)
  • es ist wichtig zu bedenken → (streichen)
  • man könnte argumentieren, dass → (streichen oder einer echten Person zuschreiben)
  • in vielerlei Hinsicht → (streichen)
  • in gewissem Maße → (streichen, es sei denn, es wird quantifiziert)
  • wohl → (streichen, es sei denn, es folgt ein Gegenargument)

Behalte Einschränkungen, wenn sie tragend sind: "etwa 40%", "in ersten Tests", "für mobile Nutzer". Diese schränken die Behauptung ein. Einschränkungen, die nur den Ton abmildern, können meist weg.

Vorher: Es sollte beachtet werden, dass die neue Richtlinie in vielerlei Hinsicht wohl eine Verbesserung ist.

Nachher: Die neue Richtlinie ist eine Verbesserung.

(Wenn der Autor wirklich meinte, dass die Verbesserung umstritten ist, sollte der nächste Satz sagen, was umstritten ist und von wem – nicht hinter "wohl" verstecken.)


9. Akronyme bei erster Nennung definieren oder entfernen

Problem: Akronyme, die der Leser nicht erkennt, machen den Text undurchsichtig.

Regeln:

  • Erste Nennung: ausschreiben, dann das Akronym in Klammern – "jährlich wiederkehrende Umsätze (ARU)"
  • Wenn das Akronym nur ein- oder zweimal vorkommt, lasse das Akronym ganz weg und verwende den vollständigen Begriff
  • Wenn das Publikum das Akronym offensichtlich kennt (API in einer Entwicklerdokumentation, BIP in einem Wirtschaftsartikel), belasse es so

Vorher: Der PM und der EM müssen sich mit dem DRI auf die OKRs vor dem EOQ abstimmen.

Nachher: Der Produktmanager und der Engineering Manager müssen sich mit dem Hauptverantwortlichen des Projekts auf die Ziele dieses Quartals einigen, bevor das Quartal endet.


10. Vage Mengenangaben präzisieren

Problem: "Viele", "verschiedene", "mehrere", "eine Reihe von", "einige" sagen dem Leser nichts.

Vorher: Eine Reihe von Kunden haben in den letzten Wochen verschiedene Probleme mit mehreren Funktionen gemeldet.

Nachher: Zwölf Kunden haben in den letzten drei Wochen Fehler in den Funktionen Export, Suche und Abrechnung gemeldet.

Wenn du die Zahlen nicht hast, hinterlasse dem Nutzer einen klaren Platzhalter, anstatt zu erfinden: "[N Kunden] meldeten…". Erfinde niemals eine Zahl.


11. Abstrakte Verben durch tatsächliche Handlungen ersetzen

Problem: Verben wie "ermöglichen", "fördern", "vorantreiben", "unterstützen", "sich auseinandersetzen mit" beschreiben eine Kategorie von Handlungen, ohne die Handlung zu nennen.

Vorher: Das neue Tool ermöglicht es Teams, bessere Ergebnisse zu erzielen und effektiver mit Stakeholdern zu interagieren.

Nachher: Das neue Tool ermöglicht es Teams, Kunden mit einem Klick Statusaktualisierungen zu senden.

Wenn du die spezifische Handlung nicht nennen kannst, frage den Nutzer. Überdecke die Lücke nicht mit einem anderen abstrakten Verb.


12. Dichte Absätze aufbrechen

Problem: Eine Textwand, in der mehrere Ideen, die jeweils einen eigenen Absatz verdienen, zusammengepackt sind. Das Auge des Lesers hat keinen Ruhepunkt.

Faustregel: Ein Gedanke pro Absatz. Wenn der Gedanke wechselt, beginne einen neuen Absatz – selbst wenn der vorherige nur zwei Sätze lang ist. Leerraum ist ein Werkzeug der Klarheit.


Vorgehen

Für jede Eingabe:

  1. Lies das Ganze zuerst. Identifiziere den Hauptpunkt. Wenn der Hauptpunkt nicht offensichtlich ist, ist das das Erste, was zu beheben ist.
  2. Schreibe Absatz für Absatz um, wende die obigen Muster an. Versuche nicht, alles in einem Durchgang zu beheben – mach es zuerst lesbar, dann schärfe nach.
  3. Lies laut vor (leise, im Kopf). Wenn ein Satz dich stolpern lässt, wird er auch den Leser stolpern lassen. Behebe es.
  4. Kürze. Die meisten Umschreibungen sind immer noch zu lang. Suche nach jedem Satz, der gestrichen werden könnte, ohne Informationen zu verlieren. Streiche ihn.
  5. Behalte Spezifika. Zahlen, Namen, Daten, technische Begriffe mit echter Bedeutung – behalte sie. Klarheit ist nicht gleichbedeutend mit vagen Aussagen.
  6. Gib nur die Umschreibung aus. Kein Vorwort, kein Kommentar.

Vollständiges Beispiel

Eingabe:

Im Lichte der kürzlich durchgeführten strategischen Überprüfung, die vom Führungsteam im Laufe des vergangenen Quartals durchgeführt wurde, und unter Berücksichtigung der verschiedenen Rückmeldungen, die von einer Reihe unterschiedlicher Stakeholder aus der gesamten Organisation eingegangen sind, wurde beschlossen, dass wir, um unsere Ressourcen besser mit unseren übergeordneten Geschäftszielen in Einklang zu bringen und nachhaltiges langfristiges Wachstum zu fördern, in den kommenden Wochen eine Reihe von betrieblichen Änderungen umsetzen werden, die unter anderem eine Umstrukturierung bestimmter Teams, eine Weiterentwicklung unseres Berichtsrhythmus und die Einführung neuer Tools umfassen, die die abteilungsübergreifende Zusammenarbeit erleichtern und die Gesamtproduktivität im großen Maßstab steigern sollen.

Ausgabe:

Letztes Quartal hat das Führungsteam eine strategische Überprüfung durchgeführt und Rückmeldungen von Teams im gesamten Unternehmen gesammelt. Basierend darauf nehmen wir in den nächsten Wochen drei Änderungen vor, um unsere Ressourcen besser auf unsere Ziele abzustimmen.

Erstens restrukturieren wir einige Teams. Zweitens ändern wir, wie oft Teams über Fortschritte berichten. Drittens führen wir neue Tools ein, damit Teams einfacher zusammenarbeiten können.

Das ist alles. Kein Abschnitt "Änderungen:". Kein kommentierter Diff. Nur die Umschreibung.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Jo5i4swastaken/Skills-Locker

Implements the "100% Retrieval Strategy" by Vercel. Injects a compressed docs index into AGENTS.md/CLAUDE.md to guarantee the agent always uses your global skills and best practices.

Jo5i4swastaken/Skills-Locker

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Jo5i4swastaken/Skills-Locker

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

Jo5i4swastaken/Skills-Locker

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

Jo5i4swastaken/Skills-Locker

Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.

Jo5i4swastaken/Skills-Locker

Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.

Jo5i4swastaken/Skills-Locker

Agent Media OS — resolve any media need (BGM, SFX, image, icon) into a frozen local file + ledger record. One verb (`resolve`) handles the full cascade — project cache, global cache, HeyGen catalog search, freeze, register. Keeps search noise on disk, hands the agent a path. Use when a composition needs background music, sound effects, images, or icons.

Jo5i4swastaken/Skills-Locker

Author a HyperFrames slideshow composition — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching sequences, and hotspot navigation. Use as an intent check when the user asks for a presentation, pitch deck, slide deck, interactive deck, or page-to-deck conversion that might be a slideshow; if the user did not explicitly ask for a slideshow / slide show, confirm before authoring.

Jo5i4swastaken/Skills-Locker

When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms, or wants to do social listening and engagement triage. Also use when the user mentions 'LinkedIn post,' 'Twitter thread,' 'social media,' 'content calendar,' 'social scheduling,' 'engagement,' 'viral content,' 'what should I post,' 'repurpose this content,' 'tweet ideas,' 'LinkedIn carousel,' 'social media strategy,' 'grow my following,' 'TikTok video,' 'Reels,' 'Shorts,' 'video script,' 'video hook,' 'short-form video,' 'create a reel,' 'social listening,' 'brand mentions,' 'competitor monitoring,' 'top posts to comment on,' 'find people asking for,' 'carousel,' 'slide-by-slide,' or 'document post.' Use this for social media content creation, repurposing, scheduling, short-form video scripting, and social listening. For broader content strategy, see content-strategy. For paid ads, see ad-creative. For earned media, see public-relations.

Jo5i4swastaken/Skills-Locker

Use when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues); client libraries and SSR integrations (supabase-js, @supabase/ssr) in Next.js, React, SvelteKit, Astro, Remix; auth issues (login, logout, sessions, JWT, cookies, getSession, getUser, getClaims, RLS); Supabase CLI or MCP server; schema changes, migrations, security audits, Postgres extensions (pg_graphql, pg_cron, pg_vector).

Jo5i4swastaken/Skills-Locker

Watch a video (URL or local path). Downloads with yt-dlp, extracts auto-scaled frames with ffmpeg, pulls the transcript from captions (or Whisper API fallback), and hands the result to Claude so it can answer questions about what's in the video.

Verwandte Skills