Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

naming-things

/naming-things

Pomaga dobierać nazwy zmiennych, funkcji, typów i plików tak, by niosły sens i pozwalały zrozumieć intencję bez szukania definicji.

Repozytorium
AI-SKILLS ↗
Licencja
MIT
Ostatnia zmiana repozytorium
05.09.2026

Ocena i bezpieczeństwo

90/ 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ść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 05.09.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

Pomaga dobierać nazwy zmiennych, funkcji, typów i plików tak, by niosły sens i pozwalały zrozumieć intencję bez szukania definicji.

Oryginalny opis (EN)

Choose names that carry meaning so readers grasp intent without chasing definitions. Use when naming variables, functions, types, or files, or when a name reads as vague.

Jak działa

  1. Method
  2. Litmus tests
  3. Boundaries
Sekcje z nagłówków SKILL.md, w oryginale · 52 linii, 416 słów
Podgląd SKILL.md
---
name: naming-things
description: Choose names that carry meaning so readers grasp intent without chasing definitions. Use when naming variables, functions, types, or files, or when a name reads as vague.
---

# Naming things

A name is the interface every reader touches and the one thing the compiler
never checks for truth. Names are read far more often than written, so a vague
one taxes every future reader to reconstruct the meaning the author already
held.

## Method

1. **Size the name to the scope it lives in.** A three-line loop index can be
   `i`; a value passed across functions or modules needs a self-explaining
   phrase like `unacknowledgedEventCount`. Wider reach and less shared context
   demand a longer name.
2. **Spell words out; refuse invented abbreviations.** Write `request`,
   `message`, or the project's already-established short form, never a one-off
   `req2`, `msg`, or `flg`. Each abbreviation trades one saved keystroke for a
   lookup on every future read.
3. **Name the concept, not the container or type.** Prefer `dueInvoices` to
   `invoiceArray` or `data`. The type already appears in the declaration; spend
   the name on the meaning the type cannot express.
4. **Make booleans read as a claim at the branch.** `isActive`, `hasAccess`,
   and `shouldRetry` read cleanly in `if (hasAccess)`. Avoid negatives like
   `notReady` that force `if (!notReady)`, a double negative readers misparse.
5. **Keep one word per concept across the codebase.** If you `fetch` in one
   module, do not `get`, `load`, and `retrieve` the same thing elsewhere. Grep
   for the existing verb before coining a new one.
6. **Rename the moment the code reveals the true concept.** The stand-in name
   `flag` that turned out to gate exports should become `exportsUnlocked` now,
   while the change is one commit, not after ten call sites depend on the vague
   name.
7. **Cost the rename before you make it wide.** A function-local name is free
   to change; an exported symbol, a serialized field, or a database column
   ripples to callers, stored data, and other repos. For those, ship the new
   name beside the old, deprecate, then remove.

## Litmus tests

- Can a reader who lands mid-file guess what the name holds without scrolling
  to its definition?
- Does every abbreviation in the diff already appear elsewhere in the project,
  or did you just invent it?
- Read each boolean aloud inside its `if`: does it state a true or false claim,
  or pose a riddle?

## Boundaries

Established domain terms and house conventions outrank these rules: match the
codebase's accent even where you would choose otherwise. Some short names are
idiomatic (`i`, `err`, `id`), and lengthening them for a rule's sake only adds
noise. Where a linter already fixes casing and prefixes, follow it.

Wersje

W bazie nie ma innych skilli o nazwie naming-things.

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

  • 90go-naming
    Podpowiada nazwy pakietów, typów, funkcji, metod i zmiennych w Go, także dla nowych typów i publicznych API.
  • 90principle-clear-naming
    Sprawdza nazwy zmiennych, funkcji, typów, plików i endpointów pod kątem czytelności i spójności między częściami systemu.
  • 100identifier-naming
    Dobiera i ocenia nazwy zmiennych, funkcji, typów, plików i folderów oraz słownictwo domenowe, a także przeprowadza zmiany nazw.
  • 100naming
    Ustala zasady nazewnictwa plików, tagów custom elementów, skilli, funkcji i zmiennych CSS tak, by nazwy opisywały zagadnienie i przetrwały refaktoryzację.
  • 100go-naming
    Podaje konwencje nazewnictwa Go dla pakietów, plików, typów, funkcji, metod, odbiorników, zmiennych, stałych, błędów, akronimów i testów, oparte na Effective Go i Go Code Review Comments.
  • 100naming-precision
    Pomaga trafnie nazywać zmienne, funkcje, klasy i pliki, unikając nazw typu data, temp czy result, tak by czytelnik nie musiał zaglądać do implementacji.

Uwagi i zgłoszenia

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