naming
/naming
Nadaje spójne nazwy kodowi, plikom, trasom i commitom oraz ekranom w języku czytelnika, a zmiany nazw robi bez kolizji.
- Autor
- ciro-maciel ↗
- Repozytorium
- ccm-stack ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 10.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 1
Brak sygnałów. Repozytorium zmienione 10.11.2026, bez odwołań do wycofanych modeli i API.
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
- The boundary is who reads it
- Casing
- Records are addressed by their stable id
- Commits
- Before a bulk rename
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
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · ciro-maciel/ccm-stack | 100 | MIT |
| cofoundy/brand-skills | 100 | MIT |
| juztripper/already-looked | 100 | MIT |
| autocss-com/ai | 100 | MIT |
| hanamizuki/solopreneur | 95 | MIT |
| hanamizuki/solopreneur | 95 | MIT |
| Esposter/Esposter | 90 | Apache-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.