naming

Identify and fix unclear identifiers to reveal developer intent across codebases.

Updated Jan 31, 2026
One-click install
npx skills add https://github.com/ddsyasas/pomodoro-app-shared --skill naming-ddsyasas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: naming
Source: https://github.com/ddsyasas/pomodoro-app-shared/tree/main/pomodoro-app/.claude/skills/naming
Command: npx skills add https://github.com/ddsyasas/pomodoro-app-shared --skill naming-ddsyasas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides developers to name variables, functions, and classes so their intent is immediately clear, reducing cognitive load and maintenance costs.

Core Features & Use Cases

  • Enforces naming principles that reveal intent for variables, functions, and classes.
  • Assists during new development, refactoring, and code reviews to improve readability.
  • Removes noise words and disallowed encodings to align with professional standards.

Use Case: In a legacy codebase with cryptic abbreviations like pcguda, apply the naming workflow to rename identifiers to descriptive, pronounceable names.

Quick Start

Apply the naming workflow to a new class with unclear names (e.g., pcguda) and rename it to a clear, pronounceable form like parseGuidedUserData.

Frequently Asked Questions about naming

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

FAQPage Schema
How do I fix unclear variable and function names during code refactoring?

To fix unclear variable and function names during code refactoring, apply a naming workflow that replaces cryptic abbreviations with descriptive, pronounceable identifiers to reveal developer intent and reduce cognitive load.

What makes a class or variable name reveal developer intent in clean code?

A class or variable name reveals developer intent in clean code by being descriptive, pronounceable, and using proper parts of speech, while actively avoiding disallowed encodings and unnecessary noise words.

How do I rename cryptic abbreviations like pcguda to improve code readability?

To rename cryptic abbreviations like pcguda and improve code readability, transform them into descriptive, pronounceable forms such as parseGuidedUserData so the identifier clearly speaks the code's intent.

Can I use this naming workflow for code reviews across different programming languages?

Yes, you can use this naming workflow for code reviews across different programming languages, as it universally enforces descriptiveness and pronunciation guidelines for variables, functions, and classes.

What are the best practices for naming functions and classes in new code creation?

Best practices for naming functions and classes in new code creation include using proper parts of speech, ensuring names are pronounceable and descriptive, and removing noise words to align with professional standards.

Why should I avoid noise words and encodings when naming variables?

You should avoid noise words and disallowed encodings when naming variables because they obscure intent, increase cognitive load, and fail to align with professional clean code readability standards.