file-name-wizard

Audit filenames and naming conventions against CLAUDE.md standards.

5|3|Updated Oct 23, 2025
One-click install
npx skills add https://github.com/Cygnusfear/claude-stuff --skill file-name-wizard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-name-wizard
Source: https://github.com/Cygnusfear/claude-stuff/tree/main/skills/file-name-wizard
Command: npx skills add https://github.com/Cygnusfear/claude-stuff --skill file-name-wizard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Inconsistent file and naming conventions lead to confusion, hinder discoverability, and complicate onboarding for new team members. This skill performs a systematic audit of all filenames and naming conventions in the codebase to identify inconsistencies, anti-patterns, and violations of standards.

Core Features & Use Cases

  • Comprehensive Filename Audit: Analyzes every file for naming convention violations (e.g., wrong case, mixed conventions).
  • Clarity & Anti-Pattern Detection: Identifies vague, misleading, temporary, or generic names (e.g., utils.ts, temp.ts).
  • Standard & Pattern Extraction: Reads CLAUDE.md files for explicit rules and identifies implicit naming patterns within directories.
  • Use Case: Run this skill on a legacy codebase to identify all naming inconsistencies and generate a report for a refactoring initiative, significantly improving code clarity and maintainability.

Quick Start

Find all source files

find . -name ".ts" -o -name ".tsx" -o -name ".js" -o -name ".jsx"

Read CLAUDE.md for explicit naming rules

cat CLAUDE.md

Frequently Asked Questions about file-name-wizard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit filename conventions across my codebase?

Filename auditing systematically scans all files to identify naming inconsistencies, case violations, and anti-patterns like vague names (`utils.ts`, `temp.ts`). Run this skill to generate a structured report with per-file findings, violation categories, and remediation guidance for refactoring.

What naming standards should I enforce in my project?

Extract explicit naming rules from `CLAUDE.md` files in your codebase, then identify implicit naming patterns within directories. This skill reads both sources to detect deviations, directory-specific rules, and cross-file mismatches so you can enforce consistent conventions.

Can I detect naming anti-patterns and vague filenames automatically?

Yes. The skill identifies clarity issues like generic names, misleading labels, and temporary file markers. It flags patterns that hinder discoverability and complicate onboarding, then outputs findings in a format compatible with downstream analysis and RAG tooling.

How do I integrate filename audits into my CI workflow?

Run this skill as part of codebase reviews, refactors, and CI pipelines to detect pattern deviations during code changes. It generates embeddable structured output that feeds into automated workflows and keeps naming conventions aligned as your codebase evolves.

Why do inconsistent filenames create problems during onboarding?

Inconsistent naming conventions reduce discoverability, confuse developers navigating unfamiliar code, and slow team ramp-up. Systematic auditing identifies these inconsistencies early so new members encounter predictable, standardized filenames that improve clarity and maintainability.

What output does the filename audit generate?

The skill produces a structured report including a per-file findings log, violation taxonomy, and remediation guidance. Output is formatted for integration with downstream analysis tools and RAG systems for actionable refactoring recommendations.