Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

Global Commenting

/Global Commenting

Prowadzi do kodu, który dokumentuje się sam dzięki nazwom i strukturze, z minimalnymi komentarzami wyjaśniającymi, dlaczego coś jest zrobione.

Repozytorium
coreyja.com ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
22.10.2026

Ocena i bezpieczeństwo

80/ 100Klasa: dobry
Format15 / 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ść25 / 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 22.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Prowadzi do kodu, który dokumentuje się sam dzięki nazwom i strukturze, z minimalnymi komentarzami wyjaśniającymi, dlaczego coś jest zrobione.

Oryginalny opis (EN)

Write self-documenting code with clear naming and structure, adding minimal, evergreen comments only when necessary to explain complex logic. Use this skill when writing or reviewing any code that might need comments. When refactoring code to make it more self-explanatory through better naming and structure. When deciding whether to add or remove comments from existing code. When ensuring comments explain why something is done rather than what is being done. When reviewing code to remove outdated or temporary change-related comments. This skill applies to all programming languages and all type

Jak działa

  1. When to use this skill
  2. Instructions
Sekcje z nagłówków SKILL.md, w oryginale · 23 linii, 159 słów
Podgląd SKILL.md
---
name: Global Commenting
description: Write self-documenting code with clear naming and structure, adding minimal, evergreen comments only when necessary to explain complex logic. Use this skill when writing or reviewing any code that might need comments. When refactoring code to make it more self-explanatory through better naming and structure. When deciding whether to add or remove comments from existing code. When ensuring comments explain why something is done rather than what is being done. When reviewing code to remove outdated or temporary change-related comments. This skill applies to all programming languages and all types of code files.
---

# Global Commenting

This Skill provides Claude Code with specific guidance on how to adhere to coding standards as they relate to how it should handle global commenting.

## When to use this skill

- When writing any new code that might require comments or explanations
- When refactoring code to improve clarity through better naming and structure
- When deciding whether to add comments to complex logic or algorithms
- When removing outdated, temporary, or change-related comments from code
- When reviewing existing comments to ensure they remain relevant and evergreen
- When writing function or method documentation
- When explaining non-obvious business logic or architectural decisions
- When working with any code file in any programming language
- When ensuring code is self-documenting through clear variable and function names
- When avoiding comments that simply describe what the code does (prefer explaining why)

## Instructions

For details, refer to the information provided in this file:
[global commenting](../../../agent-os/standards/global/commenting.md)

Wersje

W bazie nie ma innych skilli o nazwie Global Commenting.

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

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

  • 100self-explanatory-code-commenting
    Podpowiada, jak pisać samoopisujący się kod z mniejszą liczbą komentarzy, w dowolnym języku programowania.
  • 100code-comments
    Pisze, przegląda i usuwa komentarze w kodzie oraz komentarze dokumentacyjne, także w diffach.
  • 100code-comments
    Pisze czytelne komentarze i docstringi dla ludzi i agentów AI, wyjaśniając uzasadnienie i kontrakt kodu.
  • 100self-commenting
    Zostawia w kodzie wyszukiwalne znaczniki AICODE dla pamięci między sesjami: notatki, nieoczywistą logikę i poprawki błędów.
  • 100comments-review
    Przegląda plik lub diff pod kątem komentarzy, które należy zamienić na lepsze nazwy, typy, strukturę lub testy.
  • 100code-comments
    Pisze komentarze w kodzie o wysokiej wartości informacyjnej dla ludzi i agentów: komentarze liniowe, docstringi, komentarze API i lokalne uzasadnienia.

Uwagi i zgłoszenia

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