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

identifier-naming

/identifier-naming

Dobiera i ocenia nazwy zmiennych, funkcji, typów, plików i folderów oraz słownictwo domenowe, a także przeprowadza zmiany nazw.

Repozytorium
skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
19.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
6
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 19.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

Dobiera i ocenia nazwy zmiennych, funkcji, typów, plików i folderów oraz słownictwo domenowe, a także przeprowadza zmiany nazw.

Oryginalny opis (EN)

Choose or review names for variables, functions, types, files, folders, and domain vocabulary, and carry out renames. Use when the user asks what to call something, whether a name is clear or misleading, or to rename a symbol, key, file, or folder without moving it. Not for deciding where code belongs or whether to split it (codebase-structure), or for every new declaration in routine edits.

Jak działa

  1. Approach
  2. Gotchas
  3. Finish
  4. References
Sekcje z nagłówków SKILL.md, w oryginale · 35 linii, 410 słów
Podgląd SKILL.md
---
name: identifier-naming
description: Choose or review names for variables, functions, types, files, folders, and domain vocabulary, and carry out renames. Use when the user asks what to call something, whether a name is clear or misleading, or to rename a symbol, key, file, or folder without moving it. Not for deciding where code belongs or whether to split it (codebase-structure), or for every new declaration in routine edits.
license: MIT
---

# Name identifiers

Make each name convey the role, domain meaning, and consequential effects at its use site, in the project's vocabulary.

## Approach

Read the declaration and its usage before choosing a name. For a file or folder, inspect its contents and consumers to establish the responsibility the name should express. Use the project's glossary, nearby analogous operations, and language or framework conventions. Preserve exact protocol terms where they express the domain.

Use enough context to distinguish plausible alternatives without repeating what the surrounding scope already makes clear; short local names can be right. Keep cardinality, units, boolean meaning, and failure expectations accurate, and choose casing and suffixes idiomatically for the language. A name for a one-line expression can explain an important concept.

Infer what verbs such as get, load, find, validate, and verify mean from the actual contract and local usage rather than from a universal dictionary. A familiar convention guides interpretation but does not justify a name that contradicts behavior.

A name cannot settle unclear ownership, grouping, or placement. When those are unresolved, use `codebase-structure` when available, and return to naming once responsibilities are fixed.

Before renaming, distinguish internal bindings from supported public names, serialized keys, URLs, configuration, and names consumed by tools, and preserve those contracts unless changing them is part of the task. Use [rename checks](references/renames.md) whenever a rename reaches beyond a local binding, including any file or folder rename.

## Gotchas

- A private module can expose a public name through re-exports, such as Rust `pub use`. Trace entrypoints before calling a symbol internal.
- `ensure` does not make a check-and-create atomic, and `verify` does not imply cryptographic verification. Fix the name or report the behavior.
- An operation may legitimately return a result while mutating state when splitting it would lose atomicity.
- Replacing `canEdit` with `isDisabled` without inverting every use changes what true means.
- Version, adapter, and compatibility names such as `ClientV2` can be load-bearing.
- Case-only renames need verification in Git and on case-sensitive file systems.
- Search-hit counts and name length are not naming criteria. Naming difficulty can reveal an unclear responsibility, but does not by itself justify extraction, inlining, or redesign.

## Finish

Recommend a name with the behavioral distinction it clarifies. Among reasonable options, prefer the one consistent with nearby usage and avoid synonym churn. After editing, check affected consumers and relevant string references.

## References

- [Decision examples](references/examples.md) for ambiguous effects, boolean polarity, or public-name constraints.
Pliki w paczce (6)
  • LICENSE 1 KB
  • SKILL.md 3 KB
  • agents/openai.yaml 1 KB
  • references/examples.md 3 KB
  • references/renames.md 4 KB
  • references/sources.md 2 KB

Wersje

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

Migawka bazy z 13.11.2026 · wersja paczki ebbeb98e9094 (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.
  • 90naming-things
    Pomaga dobierać nazwy zmiennych, funkcji, typów i plików tak, by niosły sens i pozwalały zrozumieć intencję bez szukania definicji.
  • 100codebase-structure
    Rozstrzyga, gdzie powinien trafić kod: umieszczenie plików i modułów, dzielenie lub łączenie modułów, spłaszczanie lub zagnieżdżanie katalogów i przenoszenie plików przez granice modułów.
  • 100codebase-structure
    Wskazuje, gdzie w projekcie powinien leżeć kod: warstwy architektury, nazwy plików i folderów oraz granice pakietów.
  • 100go-naming
    Pomaga nazywać pakiety, typy, funkcje, metody, zmienne, stałe i odbiorniki w Go w sposób idiomatyczny i czytelny, także przy tworzeniu nowych typów i eksportowanych API.

Uwagi i zgłoszenia

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