Sharp Writing
Regels voor scherpe, beknopte proza in docs, READMEs en agent skills
Getest · Werkt
Wat het doet
Een single-file skill van conventies voor het schrijven van strakke, precieze proza en Markdown voor zowel menselijke als AI-lezers. Activeert vóór het schrijven van documentatie, READMEs, instructies of agent skills. Regels omvatten positieve formulering, één-idee-per-zin structuur, het weglaten van herhalende afsluitingen, en doelgroep-specifiek gebruik van em-dashes.
Testrapport
Uitgevoerd op een CLI README intro: het reduceerde een 55-woorden hype-beladen paragraaf tot 40 woorden, liet 'powerful/intuitive/essential' vallen, en verwijderde een herhalende slotzin die de 'stop at the last fact' regel verbiedt, terwijl het concreet exit-code gedrag toevoegde. Enkele zelfstandige SKILL.md zonder scripts, dus niets om te breken of te exfiltreren, en het installatiecommando plaatste het schoon in een kale HOME. De body praktiseert de beknoptheid die het predikt, dus de claims komen overeen met waargenomen gedrag.
Getest op: 2026-07-18 · Claude Code 2.x (agent harness)
Installatie
git clone https://github.com/paleo/alignfirst mkdir -p ~/.claude/skills cd alignfirst && cp -r .agents/skills/sharp-writing ~/.claude/skills/sharp-writing
Commando's en voorbeeldprompts
/sharp-writingRegels voor scherpe, beknopte proza in docs, READMEs en agent skills
Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):
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.