Sharp Writing
Regole per una prosa nitida e concisa in documenti, README e skill degli agenti
Promosso
Cosa fa
Una skill a file singolo di convenzioni per scrivere prosa e Markdown concisi e precisi sia per lettori umani che AI. Si attiva prima di scrivere documentazione, README, istruzioni o skill degli agenti. Le regole coprono la formulazione positiva, la struttura una-idea-per-frase, l'eliminazione di chiusure ridondanti e l'uso del trattino lungo specifico per il pubblico.
Rapporto di test
Eseguito su un'introduzione di un README CLI: ha tagliato un paragrafo di 55 parole carico di hype a 40 parole, ha eliminato 'powerful/intuitive/essential' e ha cancellato una frase di chiusura ridondante che la sua regola 'stop at the last fact' proibisce, aggiungendo al contempo un comportamento concreto del codice di uscita. SKILL.md singolo e autonomo senza script, quindi nulla da rompere o esfiltrare, e il comando di installazione lo ha inserito in una HOME vuota in modo pulito. Il corpo pratica la concisione che predica, quindi le sue affermazioni corrispondono al comportamento osservato.
Testato il: 2026-07-18 · Claude Code 2.x (agent harness)
Installazione
git clone https://github.com/paleo/alignfirst mkdir -p ~/.claude/skills cd alignfirst && cp -r .agents/skills/sharp-writing ~/.claude/skills/sharp-writing
Comandi e prompt di esempio
/sharp-writingRegole per una prosa nitida e concisa in documenti, README e skill degli agenti
Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):
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.