writing-clearly-and-concisely
Use when writing prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text. Applies Strunk's timeless rules for clearer, stronger, more professional writing.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Use when writing prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text. Applies Strunk's timeless rules for clearer, stronger, more professional writing.
How to use
Użyj tej umiejętności zawsze, gdy piszesz tekst dla człowieka — dokumentację, komunikaty w kodzie, opisy pull requestów, teksty interfejsu użytkownika, raporty lub wyjaśnienia.
Napisz swój wstępny draft, korzystając z własnego osądu i doświadczenia.
Jeśli masz ograniczoną ilość kontekstu, wyślij draft wraz z odpowiednią sekcją pliku do podagenta, aby przeprowadził korektę i zwrócił poprawioną wersję.
Pamiętaj o kluczowych zasadach: używaj strony czynnej zamiast biernej, formułuj zdania pozytywnie, wybieraj konkretny i specyficzny język, omijaj zbędne słowa i utrzymuj powiązane słowa blisko siebie.
Sprawdź, czy każde zdanie ma jasny cel — jeden temat na akapit, zdanie tematyczne na początku, bez zbędnych przejść między luźnymi zdaniami.