Sharp Writing
Règles pour une prose nette et concise dans les docs, READMEs et compétences d'agent
Testé · Fonctionne
Ce que fait
Une compétence mono-fichier de conventions pour écrire une prose et du Markdown concis et précis pour les lecteurs humains et IA. Se déclenche avant la rédaction de documentation, de READMEs, d'instructions ou de compétences d'agent. Les règles couvrent la formulation positive, la structure une idée par phrase, la suppression des conclusions répétitives et l'utilisation du tiret cadratin spécifique à l'audience.
Rapport de test
Je l'ai exécuté sur une introduction de README de CLI : il a réduit un paragraphe de 55 mots rempli de battage médiatique à 40 mots, a supprimé 'powerful/intuitive/essential', et a supprimé une phrase de clôture répétitive que sa règle 'stop at the last fact' interdit, tout en ajoutant un comportement de code de sortie concret. SKILL.md unique et autonome sans scripts, donc rien à casser ou à exfiltrer, et la commande d'installation l'a déposé proprement dans un HOME vierge. Le corps pratique la concision qu'il prêche, donc ses affirmations correspondent au comportement observé.
Testé le: 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
Commandes et exemples de prompts
/sharp-writingRègles pour une prose nette et concise dans les docs, READMEs et compétences d'agent
Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :
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.