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

naming

/naming

Nadaje spójne nazwy kodowi, plikom, trasom i commitom oraz ekranom w języku czytelnika, a zmiany nazw robi bez kolizji.

Repozytorium
ccm-stack ↗
Licencja
MIT
Ostatnia zmiana repozytorium
10.11.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
1
Przestarzałość

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

Nadaje spójne nazwy kodowi, plikom, trasom i commitom oraz ekranom w języku czytelnika, a zmiany nazw robi bez kolizji.

Oryginalny opis (EN)

Name code, files, routes and commits the same way everywhere, screens in the reader's language, and rename without collisions. Use when naming or renaming.

Jak działa

  1. The boundary is who reads it
  2. Casing
  3. Records are addressed by their stable id
  4. Commits
  5. Before a bulk rename
Sekcje z nagłówków SKILL.md, w oryginale · 37 linii, 317 słów
Podgląd SKILL.md
---
name: naming
description: Name code, files, routes and commits the same way everywhere, screens in the reader's language, and rename without collisions. Use when naming or renaming.
---

# Names and language

## The boundary is who reads it

Identifiers, file names, routes, comments and commit messages are in **English**: their readers are developers and tools. Everything a person reads on screen, in an e-mail or in a notification is in **that person's language**. The line is the audience, not "string or not string".

Renaming by search-and-replace cannot see that line. Replacing `search` across a codebase once turned `aria-label="Limpar busca"` into `aria-label="Limpar search"`. After any rename, search for mixed-language phrases in user-facing text.

## Casing

| Kind | Style | Example |
|---|---|---|
| Variable, function, JSON field | camelCase | `userId`, `loadPosts()` |
| Class, component | PascalCase | `PostEditor` |
| Module constant | SCREAMING_SNAKE | `MAX_RETRIES` |
| File | kebab-case | `post-editor.js` |
| Route segment | kebab-case, English | `/posts/{id}/edit` |

- **`Id`, never `ID`**: `userId`, `getById`.
- **Booleans ask a yes/no question and are affirmative**: `isOpen`, `hasAccess`, `canEdit`, `shouldRetry`. Never `notReady` or `disabled` as a boolean name.

## Records are addressed by their stable id

Routes, API paths, webhooks and public links use the record's UUID: `/posts/0b5c…/edit`, never `/post/12`. A per-account counter is a display label. A slug the customer chooses is fine for public pages.

## Commits

[Conventional Commits](https://www.conventionalcommits.org): `type(scope): summary in the imperative, lower case, no final period`. Types: `feat`, `fix`, `refactor`, `perf`, `docs`, `test`, `build`, `ci`, `chore`, `style`, `revert`. A hook checks the subject line of every `git commit -m`.

## Before a bulk rename

1. List every occurrence of the old name, and every existing occurrence of the new name.
2. Where the new name already exists with another meaning, stop and pick a different one.
3. Rename object keys at the call sites together with the function signature: a renamed parameter with old keys at the call site breaks only at runtime.
4. Run the tests and search for mixed-language text before you commit.

Wersje

RepozytoriumWynikLicencja
Ta strona · ciro-maciel/ccm-stack100MIT
cofoundy/brand-skills100MIT
juztripper/already-looked100MIT
autocss-com/ai100MIT
hanamizuki/solopreneur95MIT
hanamizuki/solopreneur95MIT
Esposter/Esposter90Apache-2.0

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

  • 100file-naming
    Nadaje plikom nazwy RRRR-MM-DD_właściciel_temat_vNN, najpierw pokazując plan zmian i kolizje nazw.
  • 100checkout-branch
    Tworzy i waliduje nazwy gałęzi Git według konwencji Conventional Commits przyjętej w tym kodzie, także przy zmianie nazw gałęzi.
  • 100cpp-naming-check
    Sprawdza konwencje nazewnictwa C++ według Google Style Guide i pomaga przy zmianie nazw identyfikatorów.
  • 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.
  • 90naming-format
    Sprawdza nazwy plików pod kątem wielkości liter i przyrostków, proponuje zmiany nazw i kontroluje eksporty.
  • 100clean-names
    Nadaje nazwy zmiennym, funkcjom, typom i plikom tak, by kod tłumaczył się sam, z długością dopasowaną do zakresu i widocznymi skutkami ubocznymi.

Uwagi i zgłoszenia

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