Naming Conventions Refactor Skill

Audit variables, functions, parameters, and files with unclear, abbreviated, or misleading names and replace them with consistent, intent-revealing alternatives.

When to Apply This Skill

Trigger on any of:

• Explicit rename requests: "rename these variables", "better function names", "fix naming"
• Readability complaints where naming is the root cause: "this is confusing", "hard to follow"
• Code review prep: "clean this up before review"
• Onboarding improvements: "new devs can't understand this codebase"
• Audit requests: "audit naming in this file/module/repo"

Step 1: Audit — Identify Naming Problems