About naming-format
A project-naming audit skill for developers that checks file casing, suffixes, exports, index files, and supported framework conventions. It reports findings by default and changes files only when asked.
Key features
- 01Filename casing checks
- 02File suffix checks
- 03Export naming checks
- 04Index file checks
- 05Next.js and Expo conventions
- 06Findings with paths and line numbers
Use cases
- 01Audit naming consistency across a codebase
- 02Find naming issues before a cleanup
- 03Apply requested file renames and import updates
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/naming-formatin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
rules/case-consistency.mdexport-naming.mdfile-suffixes.mdframework-conventions.mdindex-files.mdDetails
From the project READMEYou 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 loadrules/framework-conventions.md - Existing suffix patterns (
.test.tsvs.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:
- Rename files with
git mv - Update all import paths in dependent files
- Verify no broken imports remain after renames