enhance-docs
Use when documentation needs to be updated, clarified, or reorganized to better serve users' jobs-to-be-done with low cognitive load and high signal.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Use when documentation needs to be updated, clarified, or reorganized to better serve users' jobs-to-be-done with low cognitive load and high signal.
How to use
Przygotuj informacje wejściowe: określ, które pliki lub sekcje dokumentacji chcesz ulepszyć, zidentyfikuj główne grupy użytkowników i ich zadania (co chcą osiągnąć), wskaż źródło prawdy o zachowaniu produktu (kod, API, changelog) oraz wymień ostatnie zmiany lub planowane wydania.
Uruchom skill i podaj zakres dokumentacji. Jeśli brakuje któregoś z pięciu wejść (zakres, odbiorcy, źródło prawdy, zmiany, ograniczenia), skill poprosi o uzupełnienie.
Skill mapuje 3–5 głównych zadań użytkownika i przypisuje każdemu odpowiednie sekcje dokumentacji, aby upewnić się, że zawartość wspiera rzeczywiste cele.
Porównuje dokumentację z aktualnym kodem i API, aby znaleźć nieaktualne informacje, sprzeczności i luki. Wyniki rankuje według wpływu na powodzenie użytkownika.
Reorganizuje tekst: usuwa redundancje, skraca długie listy, dodaje jasne nagłówki i strukturę, a także wstawia minimalne przykłady tylko tam, gdzie odblokowują działanie. Priorytetyzuje zmiany o największym wpływie.
Odbierz raport z mapą zadań, rankingiem problemów, proponowanymi zmianami i szybkimi wygraniami — wszystko gotowe do wdrożenia w dokumentacji.