naming-format — скилл для Claude Code: проверка имён файлов
Скилл проверяет имена файлов, суффиксы и названия экспортов в проекте и предлагает исправления. Полезен при рефакторинге и разборе чужих репозиториев.
npx skills add tartinerlabs/skills --skill naming-format -a claude-codeЧто делает naming-format
Скилл работает как аудитор соглашений об именовании. Он сканирует проект, считает, какой стиль написания имён преобладает, ищет суффиксы вроде .test.ts против .spec.ts, смотрит на названия экспортов и файлов-индексов. По умолчанию он только отчитывается: находит нарушение, показывает path:line, объясняет, что не так, и предлагает вариант правки. Группирует находки по уровням HIGH, MEDIUM и LOW, в конце даёт счётчик нарушений по каждому правилу.
Правила про регистр, суффиксы, экспорты и индексные файлы не привязаны к языку, поэтому работают в любом проекте. Отдельный набор про фреймворки подключается только тогда, когда в package.json обнаружен Next.js или Expo. Модель у скилла — haiku, инструменты ограничены Read, Glob, Grep, Edit и Bash(git:*).
Правки скилл вносит только по прямой просьбе. Тогда он переименовывает файлы через git mv, обновляет пути импортов в зависимых файлах и проверяет, что битых импортов не осталось. Если формулировка запроса размытая, сначала идёт отчёт. Это стоит помнить: молчаливого переименования по всему репозиторию не будет, а вот забыть про динамические импорты или строковые пути скилл может, поэтому после правок прогоните тесты.
Какие задачи решает
- найти файлы с разным регистром в одном каталоге
- привести суффиксы тестов к одному виду
- проверить названия экспортов перед публикацией пакета
- разобрать чужой репозиторий и понять его соглашения
- переименовать файлы и обновить импорты
Примеры запросов агенту
- проверь имена файлов в проекте и покажи, где нарушены соглашения
- переименуй файлы в src/utils по единому стилю и поправь импорты
- посмотри экспорты в этом пакете, всё ли называется одинаково
Как установить naming-format
1Через Skills CLI (Vercel)
npx skills add tartinerlabs/skills --skill naming-format -a claude-code2Вручную: положить файлы
~/.claude/skills/naming-format/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/naming-format/
1Через Skills CLI (Vercel)
npx skills add tartinerlabs/skills --skill naming-format -a codex2Вручную: положить файлы
.agents/skills/naming-format/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add tartinerlabs/skills --skill naming-format -a cursor2Вручную: положить файлы
.cursor/skills/naming-format/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install tartinerlabs/skills naming-format2Вручную: положить файлы
.github/skills/naming-format/SKILL.md1Через Skills CLI (Vercel)
npx skills add tartinerlabs/skills --skill naming-format -a gemini-cli2Командой платформы
gemini skills install https://github.com/tartinerlabs/skills --path plugins/quality/skills/naming-formatВручную: положить файлы
.devin/skills/naming-format/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add tartinerlabs/skills --skill naming-format -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о naming-format
Как установить naming-format в Claude?
Выполните npx skills add tartinerlabs/skills --skill naming-format -a claude-code. Скилл окажется в ~/.claude/skills/naming-format/SKILL.md.
Что делает naming-format?
Проверяет имена файлов, суффиксы, названия экспортов и индексные файлы на соответствие единым правилам. По умолчанию выдаёт отчёт, а правки вносит по запросу.
Какие правила зависят от фреймворка?
Регистр, суффиксы, экспорты и индексные файлы проверяются всегда. Правила фреймворков подключаются, только если в package.json найден Next.js или Expo.
Исходный текст
SKILL.md · MIT
--- name: naming-format description: Use when reviewing file names, renaming files, fixing naming conventions, or auditing exports. Enforces consistent casing and suffix patterns. license: MIT allowed-tools: Read Glob Grep Edit Bash(git:*) model: haiku effort: medium compatibility: Any language project; casing/suffix/export rules are language-neutral, framework naming rules apply only when that framework is detected metadata: short-description: File naming and export conventions. --- You are a naming conventions expert. Audit and report by default; rename files or edit exports only when the user asks you to fix, rename, or standardise something. When the ask is unclear, report first and offer to apply the fixes. ## Rules Overview | Rule | Impact | File | |------|--------|------| | Case consistency | HIGH | `rules/case-consistency.md` | | File suffixes | HIGH | `rules/file-suffixes.md` | | Export naming | HIGH | `rules/export-naming.md` | | Index files | HIGH | `rules/index-files.md` | | Framework conventions | MEDIUM | `rules/framework-conventions.md` (only when a supported framework is detected) | ## Workflow ### Step 1: Detect Scan the project to identify: - Dominant filename casing convention (count files by pattern) - Framework indicators (e.g. Next.js/Expo in `package.json`) — used only to decide whether to load `rules/framework-conventions.md` - Existing suffix patterns (`.test.ts` vs `.spec.ts`, etc.) - Export naming patterns across the codebase The casing, suffix, export-naming, and index-file rules are language-neutral and always apply. Load `rules/framework-conventions.md` **only when a supported framework (Next.js / Expo) is detected**. ### Step 2: Audit Check all files and exports against the rules. Report each finding as `path:line` — what is wrong → the fix, grouped under `### HIGH` / `### MEDIUM` / `### LOW`, and close with a per-rule violation count. ### Step 3: Fix Apply fixes for each violation: 1. Rename files with `git mv` 2. Update all import paths in dependent files 3. Verify no broken imports remain after renames
© tartinerlabs · MIT · tartinerlabs/skills
