Are you the author? Sign in to claim
Claude Code skill for evolutionary naming — improve names step-by-step through 3 phases (audit + improve modes)
A Claude Code skill for evolutionary naming — improving names step-by-step through progressive refinement instead of trying to find the perfect name in one shot.
Naming is a process, not a single step. This skill walks names through 7 progressive steps grouped into 3 phases, with one commit per step, so improvements are safe, incremental, and reversible.
The skill is advisory: it reads code (Read/Grep/Glob) and proposes each rename plus the commit message you'd use — it doesn't edit files or run git. You apply the changes.
| Phase | Steps | Nature |
|---|---|---|
| Phase 1: Insight to Name | Missing → Nonsense → Honest → Honest and Complete | Universal. Pure naming. Safe. |
| Phase 2: Name to Structure | Honest and Complete → Does the Right Thing | Structural refactoring. Asks permission. |
| Phase 3: Combine for Design | Does the Right Thing → Intent → Domain Abstraction | Domain-level. Asks permission. |
The skill operates in two modes:
Match the depth of work to the user's actual story. Most naming improvements should stop after Phase 1.
/plugin marketplace add kawasima/evolutionary-naming
/plugin install evolutionary-naming@kawasima-skills
npx skills add kawasima/evolutionary-naming
git clone https://github.com/kawasima/evolutionary-naming.git
cp -r evolutionary-naming/skills/evolutionary-naming ~/.claude/skills/
Claude Code auto-discovers skills from ~/.claude/skills/. No configuration required.
The skill activates automatically when you ask Claude to improve naming, refactor a class/method, or review naming quality.
Audit mode triggers:
Improve mode triggers:
d を改善して"When the request is ambiguous (large code paste with no specific target), the skill asks which mode to use.
skills/evolutionary-naming/
├── SKILL.md router and overview
├── reference.md shared 7-step diagnosis, transitions, red flags
├── audit-mode.md exhaustive scan workflow + table output
└── improve-mode.md interactive single-target + pause protocol
CC BY 4.0. See LICENSE.
The 7-step / 3-phase model used in this skill is based on Arlo Belshee's "Naming as a Process" series (CC BY 3.0), one of the most thorough public treatments of evolutionary naming. The skill adapts that material into Claude Code's skill format with audit/improve modes and phase-boundary safety gates.
References:
Other influences worth exploring:
1000+ skills curated from Anthropic, Vercel, Stripe, and other engineering teams
Design enforcement with memory — keeps your UI consistent across a project
Detects 37 AI writing patterns and rewrites text with human rhythm across 5 voice profiles
WCAG accessibility audit — automated scanning, manual review, remediation