Sharp Writing
Regler for skarp, præcis prosa i docs, READMEs og agent-skills
Testet · Virker
Hvad det gør
En enkeltfils skill af konventioner for at skrive stram, præcis prosa og Markdown for både menneskelige og AI-læsere. Udløses før skrivning af dokumentation, READMEs, instruktioner eller agent-skills. Regler dækker positiv formulering, én-idé-per-sætning struktur, udeladelse af gentagende afslutninger og publikumsspecifik brug af tankestreg.
Testrapport
Kørte den på en CLI README-intro: den skar et 55-ords hype-fyldt afsnit ned til 40 ord, fjernede 'powerful/intuitive/essential' og slettede en gentagende afsluttende sætning, som dens 'stop at the last fact'-regel forbyder, samtidig med at den tilføjede konkret exit-code adfærd. Enkelt selvstændig SKILL.md uden scripts, så intet at ødelægge eller eksfiltrere, og installationskommandoen placerede den rent i en bar HOME. Teksten praktiserer den præcision, den prædiker, så dens påstande matcher observeret adfærd.
Testet: 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
Kommandoer og eksempelprompter
/sharp-writingRegler for skarp, præcis prosa i docs, READMEs og agent-skills
Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen 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.