SkillProof tested Claude skills

Doc Cleanup

Dwufazowy audyt rotacji Markdown: diagnoza oparta na dowodach, edycje tylko po zatwierdzeniu

Autor: aka-luan · aka-luan/doc-cleanup

Testowano · Działa ★ 9.6/10

Doc Cleanup — Dwufazowy audyt rotacji Markdown: diagnoza oparta na dowodach, edycje tylko po zatwierdzeniu

Co robi ten skill

Audytuje Markdown repozytorium pod kątem rotacji kontekstu — ukończone listy kontrolne nadal napisane jako instrukcje, wdrożone plany nadal napisane jako intencje, nieaktualne liczniki, martwe ścieżki i sprzeczne źródła prawdy — i wymaga dowodów z repozytorium dla każdego znaleziska przed zaproponowaniem poprawki. Najpierw uruchamia diagnozę i raport, zatrzymuje się w celu zatwierdzenia, a następnie wykonuje z playbookiem archiwizacji i przepisywania oraz weryfikacją linków/różnic. Uruchamia się na żądania przeglądu, czyszczenia lub weryfikacji dokumentacji projektu, CLAUDE.md lub AGENTS.md.

Raport z testu

Skierowano go na dokumentację wejściową i folder `docs/` aktywnego repozytorium katalogu Astro. Bez umiejętności wygenerowałem cztery wrażenia ("liczby wydają się nieaktualne", "jest zduplikowany plik protokołu"); z nią, trzynaście ustaleń, z których każde przetrwało wykonaną kontrolę — README twierdzi, że jest 64 umiejętności, gdzie `skills.json` zawiera 2433, twierdzi, że jest 12 kategorii w jednym akapicie i 8 w innym, a jego lista kontrolna uruchomienia nadal każe podłączyć endpoint newslettera, zamienić przycisk zakupu mailto na Gumroad i wygenerować obraz OG, które wszystkie zostały wysłane dawno temu. Najgorsze, co złapał, to linia w README twierdząca, że dane testowe są materiałem przykładowym, czemu zaprzeczają werdykty 1320 pass / 715 setup / 290 queue / 108 fails w zbiorze danych. Oznaczył również osierocony `docs-internal-test-protocol.md` — 56 linii odbiegało od żywego protokołu, zero odniesień przychodzących — który pomija bramę bezpieczeństwa i każe agentowi oceniać instalacje poprzez pobieranie plików zamiast ich uruchamiania. Czysty Markdown, bez skryptów, a przejście diagnostyczne naprawdę pozostawiło drzewo robocze nietknięte.

Testowano: 2026-08-10 · Claude Code 2.x (agent harness)

Instalacja

git clone https://github.com/aka-luan/doc-cleanup.git
mkdir -p ~/.claude/skills
cd doc-cleanup && cp -r skills/doc-cleanup ~/.claude/skills/doc-cleanup

Komendy i przykładowe prompty

  • /doc-cleanupDwufazowy audyt rotacji Markdown: diagnoza oparta na dowodach, edycje tylko po zatwierdzeniu

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

  • Audit our docs folder for stale instructions and dead paths
  • Check README.md for finished checklists still written as todos
  • Find contradicting sources of truth across our markdown docs

Pełny raport →