Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

hunt-comments

/hunt-comments

Wyszukuje rozwlekłe, narracyjne i martwe komentarze w kodzie, aby ograniczyć szum komentarzy i liczbę znaków.

Repozytorium
adeu ↗
Licencja
MIT
Ostatnia zmiana repozytorium
16.10.2026

Ocena i bezpieczeństwo

100/ 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ść35 / 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 16.10.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

Wyszukuje rozwlekłe, narracyjne i martwe komentarze w kodzie, aby ograniczyć szum komentarzy i liczbę znaków.

Oryginalny opis (EN)

Use when hunting down verbose, narrative, or dead comments in the codebase to reduce comment noise and character counts.

Jak działa

  1. Workflow
Sekcje z nagłówków SKILL.md, w oryginale · 29 linii, 173 słów
Podgląd SKILL.md
---
name: hunt-comments
description: Use when hunting down verbose, narrative, or dead comments in the codebase to reduce comment noise and character counts.
---

# Hunt Comments Skill

This skill provides a systematic approach to finding and reducing comment density and character bloat across source code files.

## Workflow

1. **Run the Comment Density Spotter**:
   Execute `python scripts/count_comment_chars.py` to rank files by comment character count:
   
   ```bash
   uv run python scripts/count_comment_chars.py -n 25
   ```

2. **Target High-Density Files**:
   Focus on top-ranked files with high comment ratios (>20% comment characters).

3. **Identify & Remove Non-Essential Commentary**:
   - Delete narrative historical explanations ("Why we added this in 2024...", "Fix for issue #123 where...").
   - Strip redundant docstrings that simply restate function signatures, types, or obvious operations.
   - Collapse multi-paragraph block comments into brief 1-line "why" notes or remove them entirely if code is self-explanatory.
   - Retain only essential architectural invariants (e.g., OPC part boundaries, Word signed int32 overflow rules, security guards).

4. **Verify Behavior**:
   Always run test suites to verify zero functional or formatting regressions:
   - Python: `uv run pytest` & `uv run mypy src`
   - Node: `npm run build && npm test`
   - LangChain: `uv run pytest` in `langchain`

Wersje

W bazie nie ma innych skilli o nazwie hunt-comments.

Migawka bazy z 13.11.2026 · wersja paczki 6667df8a70e5 (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

  • 100code-comment-style
    Pisze i skraca komentarze w kodzie tak, by w 1-3 linijkach podawały powód lub niezmiennik.
  • 90no-comments
    Audytuje komentarze w diffie lub plikach przed przeglądem, usuwa martwe i narracyjne, a ukryte obejścia zamienia na kod.
  • 100code-comments
    Pisze, przegląda i usuwa komentarze w kodzie oraz komentarze dokumentacyjne, także w diffach.
  • 100comments-docs
    Ocenia jakość komentarzy i praktyk dokumentacyjnych: cztery typy komentarzy, kolejność komentarze najpierw oraz psucie się komentarzy z czasem.
  • 100comment-cleanup
    Czyści komentarze w plikach lub folderach: usuwa zbędne, powtarzające kod i kronikujące stare zmiany.
  • 100comment-sweep
    Porządkuje lub audytuje komentarze w gałęzi lub diffie przed recenzją: usuwa zbędne i martwe komentarze, zostawia wartościowe.

Uwagi i zgłoszenia

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