Przejdź do treści
Biblioteka skilli
Dokumenty i biuro · Pisanie

docs-hygiene

/docs-hygiene

Porządkuje dokumenty źródłowe i tabele statusów w trzech miejscach prawdy oraz aktualizuje formuły godzin przy każdym przeglądzie.

Repozytorium
shaft_engine ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

85/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść20 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Porządkuje dokumenty źródłowe i tabele statusów w trzech miejscach prawdy oraz aktualizuje formuły godzin przy każdym przeglądzie.

Oryginalny opis (EN)

Use when editing source-of-truth docs or status tables: three sources, Done / In progress / Not started, and live hour formulas. On demand only.

Jak działa

  1. Three source-of-truth files
  2. Status vocabulary
  3. Hours
  4. Journey maps
  5. Delete-guard upstream
  6. SHA-bound review
Sekcje z nagłówków SKILL.md, w oryginale · 33 linii, 265 słów
Podgląd SKILL.md
---
name: docs-hygiene
description: "Use when editing source-of-truth docs or status tables: three sources, Done / In progress / Not started, and live hour formulas. On demand only."
license: MIT
permissions:
  - read
---

# Docs hygiene

Load this skill when the deliverable edits the three source-of-truth documents, a status table, a journey map, or hour totals. On demand only. It does not publish product docs.

Run `python3 .chaos-engine/tool.py retrieve --store graphify "docs hygiene status journey"` before a broad search and record `retrieve: used|skipped(<reason>)`.

## Three source-of-truth files

Name the three source-of-truth files at the start. Edit those files. A summary, a slide, or a chat note is not a fourth source of truth.

## Status vocabulary

Status cells use exactly one of: **Done**, **In progress**, **Not started**. Do not invent synonyms in the table.

## Hours

For every Done row, completed hours equal planned hours. In progress and Not started rows are not forced to that equality. The cells are live formulas, not pasted numbers. A hand-typed total that can drift from the plan is a failure.

## Journey maps

Journey maps agree with each other and with the source-of-truth status. Do not merge a partial journey as the full journey. A partial map stays labeled partial until the missing legs exist.

## Delete-guard upstream

If a delete-guard requires an upstream, push a start commit first, then delete in a follow-up. That is an allowed exception to a single push. Never use `--no-verify`, and never edit allowlists to bypass the guard.

## SHA-bound review

A review claim cites the head SHA it read. A review of an older SHA is not a review of the current head. Re-read after every new commit.

Enforced by [`lessons_2026_11_06.py`](../../rules/lessons_2026_11_06.py) (`evaluate_docs_hygiene`). The closed ticket this skill completes stays closed; do not refile it.

Wersje

W bazie nie ma innych skilli o nazwie docs-hygiene.

Migawka bazy z 13.11.2026 · wersja paczki ed7c96553b2e (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90docs-single-source
    Linkuje dokumentację do jednego źródła prawdy zamiast powtarzać treść, przy pisaniu i przebudowie docs, edycji README lub CLAUDE.md i kopiowaniu listy z kodu.
  • 84setup
    Sprawdza, czy markdownlint-cli2 działa w repozytorium, i ustawia opcję kompresji artykułów dla higieny dokumentacji.
  • 100spreadsheet-formula-helper
    Pisze i debuguje formuły arkuszy (Excel, Google Sheets), tabele przestawne i formuły tablicowe oraz tłumaczy je między dialektami, z przykładami i sprawdzeniem przypadków brzegowych.
  • 100xlsx
    Czyta, tworzy i edytuje arkusze Excel, porządkuje nieuporządkowane tabele i dodaje kolumny, formuły, style oraz wykresy.
  • 100reference-docs
    Opisuje wzorce dokumentacji referencyjnej dla API i symboli: dokumenty referencyjne, tabele parametrów i specyfikacje techniczne.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.