Sharp Writing

Zasady ostrej, zwięzłej prozy w dokumentacji, README i umiejętnościach agenta

Testowano · Działa ★ 9.2/10

Co robi ten skill

Umiejętność w jednym pliku zawierająca konwencje pisania zwięzłej, precyzyjnej prozy i Markdown dla czytelników ludzkich i AI. Uruchamia się przed pisaniem dokumentacji, README, instrukcji lub umiejętności agenta. Zasady obejmują pozytywne sformułowania, strukturę jedna-idea-na-zdanie, eliminowanie powtarzających się zakończeń i użycie myślnika em-dash specyficzne dla odbiorcy.

Raport z testu

Uruchomiono go na wstępie do README CLI: skrócił 55-wyrazowy, pełen szumu akapit do 40 słów, usunął 'powerful/intuitive/essential' i usunął powtarzające się zdanie końcowe, którego zabrania jego zasada 'stop at the last fact', dodając jednocześnie konkretne zachowanie kodu wyjścia. Pojedynczy, samodzielny SKILL.md bez skryptów, więc nic do zepsucia ani wycieku, a polecenie instalacji umieściło go w czystym HOME. Treść praktykuje zwięzłość, którą głosi, więc jej twierdzenia odpowiadają obserwowanemu zachowaniu.

Testowano: 2026-07-18 · Claude Code 2.x (agent harness)

Instalacja

git clone https://github.com/paleo/alignfirst
mkdir -p ~/.claude/skills
cd alignfirst && cp -r .agents/skills/sharp-writing ~/.claude/skills/sharp-writing

Komendy i przykładowe prompty

/sharp-writingZasady ostrej, zwięzłej prozy w dokumentacji, README i umiejętnościach agenta

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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.

Pełny raport →