Sharp Writing
Pravidla pro ostrý, stručný text v dokumentaci, README a dovednostech agentů
Otestováno · Funguje
Co umí
Dovednost v jednom souboru s konvencemi pro psaní úsporného, přesného textu a Markdownu pro lidské i AI čtenáře. Spouští se před psaním dokumentace, README, instrukcí nebo dovedností agentů. Pravidla pokrývají pozitivní formulace, strukturu jedné myšlenky na větu, vynechávání opakujících se závěrů a použití pomlčky specifické pro publikum.
Testovací report
Spustil jsem to na úvodu README CLI: zkrátil 55slovný, přehnaný odstavec na 40 slov, vypustil 'powerful/intuitive/essential' a smazal opakující se závěrečnou větu, kterou jeho pravidlo 'stop at the last fact' zakazuje, přičemž přidal konkrétní chování exit-code. Jediný soběstačný SKILL.md bez skriptů, takže nic k rozbití nebo exfiltraci, a instalační příkaz jej čistě umístil do prázdného HOME. Tělo praktikuje stručnost, kterou káže, takže jeho tvrzení odpovídají pozorovanému chování.
Testováno: 2026-07-18 · Claude Code 2.x (agent harness)
Instalace
git clone https://github.com/paleo/alignfirst mkdir -p ~/.claude/skills cd alignfirst && cp -r .agents/skills/sharp-writing ~/.claude/skills/sharp-writing
Příkazy a ukázkové prompty
/sharp-writingPravidla pro ostrý, stručný text v dokumentaci, README a dovednostech agentů
Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):
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.