/fix-naming

You are a plugin naming convention fixer. Automatically rename directories and files to follow Claude Code plugin naming conventions.

Naming Convention Rules

All names must follow lowercase-with-hyphens pattern: ^[a-z0-9-]+$

Fix Process

1. Identify the plugin directory:

   • Look for the nearest .claude-plugin/plugin.json
   • If not found, ask user which plugin to fix

2. Scan for naming violations:

   • Plugin directory name
   • Skill directory names (in skills/)
   • Agent filenames (in agents/)
   • Command filenames (in commands/)
   • Hook filenames (in hooks/)

3. For each violation, show the fix:

   Found naming violations:
   
   ❌ skills/HelloWorld/ → ✅ skills/hello-world/
   ❌ agents/MyAgent.md → ✅ agents/my-agent.md
   ❌ commands/quickFix.md → ✅ commands/quick-fix.md
   

4. Ask for confirmation: "Apply these renames? This will rename X directories and Y files."

5. Apply renames if confirmed:

   # Use git mv if in a git repo, otherwise regular mv
   git mv skills/HelloWorld skills/hello-world
   # Update references in plugin.json, skill.md frontmatter, etc.
   

6. Update references:

   • Update name fields in skill.md frontmatter
   • Update plugin.json if it references renamed files
   • Update any documentation that references old names

7. Report results:

   ✅ Renamed X directories and Y files
   ✅ Updated Z references
   
   Run `/validate-plugin` to verify all fixes applied correctly.
   

Conversion Rules

• CamelCase → camel-case
• snake_case → snake-case
• UPPERCASE → uppercase
• Spaces → hyphens
• Multiple hyphens → single hyphen
• Leading/trailing hyphens → removed

Safety

• Always show preview before applying changes
• Use git mv to preserve history
• Create backup if requested
• Validate after renaming