Sharp Writing
Regler for skarp, konsis prosa i dokumenter, READMEs og agentferdigheter
Bestått
Hva den gjør
En enkeltfils ferdighet med konvensjoner for å skrive stram, presis prosa og Markdown for både menneskelige og AI-lesere. Utløses før skriving av dokumentasjon, READMEs, instruksjoner eller agentferdigheter. Reglene dekker positiv formulering, én-idé-per-setning-struktur, kutting av gjentakende avslutninger, og publikumsspesifikk bruk av em-dash.
Testrapport
Kjørte den på en CLI README-introduksjon: den kuttet et 55-ords hype-fylt avsnitt til 40 ord, droppet 'powerful/intuitive/essential', og slettet en gjentakende avslutningssetning som dens 'stop at the last fact'-regel forbyr, samtidig som den la til konkret exit-kode-atferd. Enkelt selvstendig SKILL.md uten skript, så ingenting å bryte eller eksfiltrere, og installasjonskommandoen droppet den inn i en bar HOME rent. Teksten praktiserer den konsisjonen den forkynner, så dens påstander samsvarer med observert atferd.
Testet på: 2026-07-18 · Claude Code 2.x (agent harness)
Installer
git clone https://github.com/paleo/alignfirst mkdir -p ~/.claude/skills cd alignfirst && cp -r .agents/skills/sharp-writing ~/.claude/skills/sharp-writing
Kommandoer og eksempelprompter
/sharp-writingRegler for skarp, konsis prosa i dokumenter, READMEs og agentferdigheter
Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):
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.