CommunitySchreiben & Editierengithub.com

Prosa-Lektorat

Geht von **korrekten Fakten** aus. Es geht um die Worte und die Form, nicht um die Fakten. `NOTES.md` neben dieser Datei enthält ausgearbeitete Beispiele.

Was ist Prosa-Lektorat?

Dieses Skill dient dem professionellen Lektorat und der Feinschliff von geschriebenen Texten wie Dokumentationen, Runbooks, READMEs, Berichten, Prompts und Anleitungen für Modelle. Es wird beim Überarbeiten oder Prüfen von Prosa eingesetzt, wenn ein Entwurf ausufernd oder vage ist, oder bevor geschriebene Arbeiten veröffentlicht werden. Das Skill leitet dazu an, unnötige Füllwörter, Wiederholungen und generische KI-Muster zu entfernen, ohne die Substanz zu kürzen, und bewahrt stets die Begründung (das „Warum“) als schützenswerten Kern. Es unterstützt Entwickler und Autoren dabei, klare, präzise und handlungsorientierte Texte zu verfassen, die für den jeweiligen Leser und Anwendungsfall optimiert sind.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/productivelyslacking/agent-skills/tree/HEAD/skills/prose-editing

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation


name: prose-editing description: Schneiden und Formen von schriftlichen Arbeiten: Dokumentationen, Runbooks, READMEs, Berichte, Prompts und Anleitungen für Modelle. Verwenden beim Bearbeiten oder Prüfen von Prosa, wenn ein Entwurf ausufernd oder vage ist, oder bevor schriftliche Arbeiten veröffentlicht werden.

Was macht Prosa-Lektorat?

Geht von korrekten Fakten aus. Es geht um die Worte und die Form, nicht um die Fakten. NOTES.md neben dieser Datei enthält ausgearbeitete Beispiele.

Der Test

Jeder Satz sagt dem Leser, was er tun soll, was er erwarten kann oder was passiert, wenn er es falsch macht; streiche einen Satz, der nichts davon tut. Prägnanz ist nicht Kürze: Schneide niemals Substanz weg, um eine Länge zu erreichen, sondern das Gerüst darum herum.

Streichen

  • Hüsteln. Setze die Substanz in den ersten Satz.
  • Wiederholungen. Sag es einmal, an der besten Stelle.
  • Füllwörter als Übergänge („es ist erwähnenswert, dass“, „wie oben erwähnt“, „um zu“).
  • Kommentare, die kein Verhalten ändern („unglamourös, aber wichtig“).
  • Vage Quantifizierung („ein überraschender Anteil“). Nenne den wahren Grund, warum es funktioniert, oder streiche die Behauptung.
  • Absicherungen, die eine Festlegung vermeiden. Formuliere echte Unsicherheit klar mit den Entscheidungskriterien.
  • Blockzitate zur Hervorhebung. Behalte sie für Warnungen, die das Verhalten des Lesers ändern.

Streichen, was Text als generiert kennzeichnet

Ein Modell wählt, was für die breiteste Leserschaft passt; ein Autor wählt für einen Leser und ein Thema. Suche zuerst nach der Struktur, weil sich die Wortgewohnheiten mit jedem Modell ändern. Ein Satz bleibt nur, wenn er diesem Leser etwas gibt, das er noch nicht hat.

  • Inszenieren statt Aussagen. „Nicht X, sondern Y“, wenn niemand X gesagt hat, ein einzeiliger Abschluss, der den Punkt wiederholt, ein Anlauf vor dem Punkt, ein Spruch, der tief klingt und nichts behauptet. Formuliere die Tatsache.
  • Rhythmus nach Schema. Überall Triaden und Gedankenstriche, wiederholte Satzanfänge, gestapelte Einschränkungen. Verwende drei Elemente, wenn es drei sind.
  • Aufblähen. Gewöhnliche Fakten werden als entscheidend oder robust bezeichnet, Verkaufssprache, ungenannte Autoritäten, „-end“-Anhängsel, die eine Bedeutung andeuten. Sage, was es tut, oder streiche es.
  • Formatierung nach Schema. Jedes Element fett, jeder Gedanke eine Überschrift, wo Hervorhebung oder Struktur nichts bedeuten.
  • Entwurfsreste. Chat-Umrandungen, Haftungsausschlüsse zu Wissensgrenzen, eine Überschrift, die als erster Satz wiederholt wird, Text über das Dokument statt über sein Thema.
  • Der falsche Leser. Erkläre bereits Bekanntes erneut, sodass die Entscheidung zuletzt kommt.

Behalte, was der Autor meinte, und füge nichts hinzu, um das Gestrichene zu ersetzen. Ein echter Kontrast, eine echte Liste von drei oder eine zitierte Quelle bleibt; ein Erkennungsmerkmal zählt nur, wenn es nichts hinzufügt.

Geschützt: Das Warum ist nie Füllmaterial

Behalte einen Satz, der erklärt, warum (diese Reihenfolge, dieses Werkzeug, diese Prüfung zuerst, dieser Schritt kann nicht übersprungen werden), auch wenn er keine Anweisung gibt: Der Grund ermöglicht es dem Leser, mit dem Fall umzugehen, den das Dokument nicht vorhergesehen hat, und zu erkennen, wann das Verfahren nicht mehr gilt. Gib den Grund überall dort an, wo er nicht offensichtlich ist, vor allem bei Sicherheits- und Compliance-Regeln, wo die Absicht es jemandem erlaubt, die Regel anzuwenden, wo keine sie abdeckt. Wenn ein Satz eine Ausschmückung und einen Grund enthält, schreibe ihn um, um den Grund zu behalten. Der Test ist: „Wäre der Leser ohne diesen Satz schlechter in dieser Sache?“

Unverdiente Struktur streichen

Füge Ebenen, Tabellen, Matrizen, verschachtelte Überschriften oder Verzweigungen nur dort hinzu, wo die Arbeit sie braucht, nicht weil sie streng wirken. Frage: Verzweigt die Arbeit hier tatsächlich (wenn jeder Leser denselben Weg nimmt, ist es eine Liste)? Ist dieser Schritt nötig oder wirkt er nur gründlich? Wenn das Verfahren vier Schritte hat, schreibe vier: Ein vierstufiges Verfahren, das beim ersten Lesen befolgt wird, schlägt ein korrektes neunstufiges, das überflogen wird. Fallstricke, Sequenzfallen und das Warum bleiben.

Anleitungen, die ein Modell lädt

Regelblätter, Skills, Rollenbeschreibungen und Prompts werden mit Token bezahlt, jedes Mal wenn sie geladen werden, und der Leser ist ein Modell, das die Regel braucht, nicht die Geschichte dazu. Bepreise sie nach dem Zeitpunkt des Ladens (D28):

  • Jede Sitzung (Regelblätter, Skill- und Rollenbeschreibungen): nur die Regel. Eine Beschreibung sagt, was das Skill abdeckt und wann es geladen werden soll, in unter 300 Zeichen; tools/check.py erzwingt die Budgets.
  • Bei Verwendung (ein Skill- oder Rollenkörper): die Regel plus ein Grund. Nur ein konkretes Versagen, wenn die Regel ohne es als optional erscheint, ohne Daten, Zählungen oder Projektnamen.
  • Auf Abruf (NOTES.md, EVIDENCE*.md): die Vorfälle, Zahlen, Daten und Quellen. Der Körper verweist dorthin.

Schreibe im Imperativ. Wiederhole keine Regel, die eine andere geladene Datei enthält; verweise mit Namen darauf. Eine festgelegte Anforderung in docs/REQUIREMENTS.tsv zieht mit ihrer Neufassung um, nie stillschweigend.

Aufbau eines Verfahrens

Zweck → Wann verwenden → Vorbereitung → Schritte → Überprüfen → Wenn es nicht funktioniert → Eskalieren

  • Nie „Überprüfen“ weglassen: Es ist der am häufigsten übersprungene und wertvollste Teil.
  • Ein Schritt pro Aktion. Benenne UI-Elemente exakt. Gib den vollständigen Pfad an.
  • Kennzeichne irreversible Schritte vor dem Schritt, nicht danach.
  • Schreibe für einen kompetenten Fremden: Kennt die Domäne, hat diese Umgebung nie gesehen.
  • Titel nennen, wonach jemand suchen würde. Keine Daten, Versionen oder „v2“.

Ton

  • Klare Sprache, kurze Sätze.
  • Weiche keine Konsequenzen mit Zähnen auf (Verfall, Kündigung, Datenverlust, persönliche Haftung): Sage es deutlich.
  • Verlinke Herstellerdokumentation, anstatt sie zu kopieren, und dokumentiere nur, was für die eigene Arbeitsweise spezifisch ist: Ein Nachdruck ist bei Ankunft veraltet.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills