file-name-wizard

Overview

A Claude Code skill that performs a systematic audit of all filenames and naming conventions in a codebase against AGENTS.md standards and common patterns. It discovers all files, extracts naming rules, identifies implicit patterns, and produces a detailed report of violations, clarity issues, anti-patterns, and organizational problems.

Key Features

• Multi-Phase Audit Process - Systematically discovers all files, extracts naming standards from AGENTS.md files, identifies implicit patterns, and audits each file individually
• Convention Violation Detection - Catches wrong case usage (e.g., PascalCase where kebab-case is expected), mixed conventions, and inconsistencies with directory patterns
• Clarity Issue Identification - Flags vague names (utils.ts, helpers.ts), overly verbose names, misleading names, and abbreviations without context
• Anti-Pattern Detection - Identifies temporary names (temp.ts, test.ts), generic names (index2.ts), dated names (old-.ts, legacy-.ts), and feature flag names (*-new.ts)
• Content Verification - Reads file contents to verify that filenames accurately describe what is inside, suggesting better names when they do not match

Who is this for?

This skill is for development teams that want to enforce consistent naming conventions across their codebases. It is especially valuable during code reviews, refactoring efforts, or when onboarding new team members who need to understand and follow the project's naming standards.