claude-skill-naming

claude-skill-naming

A Claude Code skill that helps programmers solve naming problems through guided Q&A and curated suggestions.

What It Does

Naming things is hard. This skill turns the "what should I call this?" moment into a structured, interactive conversation:

1. Identifies what you're naming (project, variable, function, class, file, API route, DB table, etc.)
2. Asks focused questions to understand purpose, language/stack, and constraints
3. Generates 4–6 tiered name candidates with reasoning
4. Refines based on your feedback until you find the right fit

Defaults to English names. Chinese or other languages supported on request.

Supported Targets

Target	Example output
Project / repo	video-dl, token-refresher
npm / pip package	zod-form-bridge, async-retry
Variable	pendingOrderIds, isLoading
Function / method	retryFailedPayment(), parseConfig()
Class / interface	UserRepository, PaymentAdapter
File / directory	UserCard.tsx, user_service.py
API route	/user-profiles/{id}/orders
Database table/column	user_profiles, created_at
Feature flag / env var	FEATURE_VIDEO_DOWNLOADER
CSS class / design token	.user-card__avatar, --color-primary

Installation

Via Claude Code plugin system

/plugin marketplace add atompilot/claude-skill-naming
/plugin install claude-skill-naming@claude-skill-naming

Manual (development)

# Clone the repo
git clone https://github.com/atompilot/claude-skill-naming.git ~/.claude/plugins/claude-skill-naming

# Restart Claude Code — the skill auto-discovers

Usage

Just describe what you need to name — in English or Chinese:

> Help me name a TypeScript utility function that retries a failed HTTP request up to 3 times

> 帮我给这个项目命名，它是一个自动下载抖音视频的 CLI 工具

> What should I call this React hook that tracks scroll position?

> Give me naming suggestions for a Python class that validates email addresses

Claude will ask 1–3 clarifying questions, then present ranked suggestions with explanations.

Example Session

User: I need a name for a Go function that loads user settings from a config file.

Claude: What does the function return — the entire config struct, or just a specific section?
        And is this in an internal package or a public API?

User: Returns the full AppConfig struct. Internal package.

Claude: ## Naming Suggestions

        **Recommended**
        1. `loadConfig` — concise, standard Go idiom for loading from file
        2. `loadAppConfig` — more specific if multiple config types exist

        **Also Consider**
        3. `readConfig` — emphasizes file I/O over the result
        4. `initConfig` — common pattern if called once at startup

        **If you follow a `mustX` pattern for fatal errors**
        5. `mustLoadConfig` — signals it panics on failure

What's Inside

skills/
└── naming/
    ├── SKILL.md                        ← Core skill: workflow, principles, special cases
    └── references/
        └── naming-conventions.md       ← Full reference: case styles, language defaults,
                                          conventions by target type, anti-patterns

Key Principles

• Intent over implementation — names reveal what, not how
• Language-aware — applies correct case convention per language (camelCase for JS/TS, snake_case for Python/Go/Rust, etc.)
• Codebase-consistent — matches your existing naming patterns when provided
• Concise but not cryptic — targets 1–3 words, avoids meaningless filler (data, temp, util)

Language Convention Quick Reference

Language	Variables	Functions	Classes	Files
TypeScript / JS	camelCase	camelCase	PascalCase	kebab-case
Python	snake_case	snake_case	PascalCase	snake_case
Go	camelCase	camelCase/PascalCase*	PascalCase	snake_case
Rust	snake_case	snake_case	PascalCase	snake_case
Swift	camelCase	camelCase	PascalCase	PascalCase

*Go: PascalCase = exported, camelCase = unexported

Full reference in skills/naming/references/naming-conventions.md.

License

MIT