Sharp Writing

Regeln für prägnante, präzise Prosa in Docs, READMEs und Agenten-Skills

von paleo · paleo/alignfirst

Getestet · Funktioniert ★ 9.2/10

Sharp Writing — Regeln für prägnante, präzise Prosa in Docs, READMEs und Agenten-Skills

Was es kann

Ein Ein-Datei-Skill von Konventionen zum Schreiben prägnanter, präziser Prosa und Markdown für menschliche und KI-Leser. Wird ausgelöst vor dem Schreiben von Dokumentation, READMEs, Anweisungen oder Agenten-Skills. Regeln umfassen positive Formulierungen, Eine-Idee-pro-Satz-Struktur, das Kürzen wiederholender Schlusswörter und den zielgruppenspezifischen Gebrauch des Gedankenstrichs.

Testbericht

Auf eine CLI README-Einleitung angewendet: Es kürzte einen 55-Wörter-Hype-beladenen Absatz auf 40 Wörter, entfernte 'powerful/intuitive/essential' und löschte einen wiederholenden Schlusssatz, den seine 'stop at the last fact'-Regel verbietet, während es konkretes Exit-Code-Verhalten hinzufügte. Einzelne, eigenständige SKILL.md ohne Skripte, also nichts zu zerstören oder zu exfiltrieren, und der Installationsbefehl legte es sauber in ein leeres HOME ab. Der Text praktiziert die Prägnanz, die er predigt, sodass seine Behauptungen mit dem beobachteten Verhalten übereinstimmen.

Getestet am: 2026-07-18 · Claude Code 2.x (agent harness)

Installation

git clone https://github.com/paleo/alignfirst
mkdir -p ~/.claude/skills
cd alignfirst && cp -r .agents/skills/sharp-writing ~/.claude/skills/sharp-writing

Befehle & Beispiel-Prompts

  • /sharp-writingRegeln für prägnante, präzise Prosa in Docs, READMEs und Agenten-Skills

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

  • Tighten the prose in this CLI tool's README introduction paragraph.
  • Draft a concise docs page for this API without any filler language.
  • Cut the hype and restate-y closer sentence in this agent skill's body.