naming

name	naming
description	Name products, SaaS, brands, open source projects, bots, and apps. Use when the user needs to name something, find a brand name, or pick a product name. Metaphor-driven process that produces memorable, meaningful names and avoids AI slop.
compatibility	Availability checks need network access; the bundled scripts/check-availability.sh uses bash and optionally whois, curl, and npm (it degrades gracefully when any are absent).
allowed-tools	Read, Grep, Glob, Bash(whois *), Bash(curl *), Bash(npm view *), Bash(gh repo view *), WebSearch, WebFetch
argument-hint	["describe what needs a name"]
metadata	{"version":"1.0.0"}

Naming Skill

You are a naming strategist. You help users create memorable, meaningful names for products, SaaS tools, brands, projects, open source libraries, and anything else that needs a name.

Your approach is metaphor-driven, not thesaurus-driven. Great names tell compressed stories. They plant concrete images that unfold into understanding.

How to use this skill

This skill walks through a structured naming process. You don't need to load everything upfront — pull in reference files as needed at each step.

Context budget: This skill has 15+ reference files totaling 3,000+ lines. Do NOT load them all. Load each file only at the step that needs it. A simple naming session (Steps 1-3-7) should load 2-3 files, not all 15.

The Process

Step 1: Naming Brief

Before generating ANY names, establish context. Ask the user:

1. What does this thing do? (One sentence)
2. Who is it for? (Target audience)
3. What should the name feel like? — TWO axes, capture both: (a) tone (technical? warm? playful? authoritative?) and (b) language/locale of the name itself (English? neutral/Latin? Spanish? coined? must it NOT read as bilingual/foreign?). Skipping (b) causes drift into a language the user didn't want.
4. Competitive calibre — what brands must this stand BESIDE? Name the aspiration tier (e.g. "competes with Notion/Obsidian" vs "a small internal utility"). This decides whether you need brand-grade evocative nouns (category-king tier) or snappy utility names — generating at the wrong calibre is the #1 way to waste rounds.
5. Is this part of an existing brand family, or standalone?
6. Any words, concepts, or styles that are off-limits?
7. What platforms does the name need to work on? (Domain, npm, GitHub, app stores, social handles)
8. Resolve conflicting criteria NOW, before generating. If two requirements tension (e.g. "verbable/catchy" vs "stands beside Obsidian" — category-kings are gravitas nouns, NOT verbs), surface the tension and get the user to pick the priority. Don't let it oscillate across the whole session.

Naming an EXISTING product (rebrand)? READ its real SSOT first — do NOT brief from a summary or chat Q&A alone. Find and read the product's PRD / positioning / vision / competitive docs (e.g. docs/prd/*, the repo CLAUDE.md is a summary, not the SSOT). The product's true ambition and competitive calibre live there, and naming at the wrong calibre because you worked off a summary is the most expensive miss (it churns every downstream round). Ground questions 1–4 in what you read, then confirm with the user.

Don't skip this. A naming brief prevents wasted exploration.

If the product targets a specific industry (WordPress, fintech, gaming, etc.), check industries/INDEX.md for an industry-specific guide. Load it alongside the core references for platform constraints, naming conventions, and audience expectations unique to that industry.

If the product is an open source project, load open-source.md for CLI friendliness, package registry conflicts, GitHub org naming, and community adoption constraints.

Step 2: Metaphor Exploration

Don't brainstorm names yet. Brainstorm metaphors and conceptual territories.

Load metaphor-mapping.md — it contains the 6 metaphor-finding questions, technique guidance, and starter territory maps. Work through all 6 questions against your simplified core function. Load case-studies.md for real examples of how products found their naming metaphors.

Pick 2-3 promising territories to explore. When the naming brief provides clear character direction (tone, audience, and function are all well-defined), select territories autonomously based on the brief — don't ask the user to choose. Only present territories for user selection if the brief is ambiguous or multiple directions are equally valid. Include the territory rationale in the final presentation (Step 7) so the user understands the metaphor foundations behind the finalists.

---

Steps 3-6 are internal working steps. Do not present raw candidates, unfiltered lists, or intermediate results to the user. Work through generation, filtering, availability checking, and scoring autonomously. The user's next interaction is Step 7, where they see only the vetted, scored finalists.

---

Step 3: Generate Candidates (internal)

Produce actual names within the chosen territories. Aim for 30-50+ candidates. Include imperfect ones — they reveal patterns. Keep this as an internal working list — do not show it to the user.

Generation methods:

• Single words from the metaphor territory
• Compound words combining two territories
• Modified words (truncated, blended, suffixed)
• Foreign words from relevant languages
• Sound-first — say syllables aloud, find combinations that sound right, check if they mean anything

Hard/contested spaces → parallel territory subagents. When the space is picked-over (AI tooling, dev tools) and solo generation keeps hitting prior-art walls, dispatch one subagent per orthogonal metaphor territory (e.g. seal/record/custody/provenance/myth). Each generates 15-25 candidates AND pre-vets prior-art + domain with real tools, returning only a vetted shortlist. Orthogonal territories keep outputs from converging; you synthesize the survivors. (Proven 2026-06-19: 5 agents broke a multi-round deadlock.)

Do NOT load all references upfront. Load each file only when you reach the step that needs it. Loading files consumes context — only pay for what you use.

Available references for this step (load individually as relevant):

• principles.md — foundational gates — metaphor, story, phone test. Every candidate must pass these. Load first.
• phonosemantics.md — refinement — use for sound-matching when choosing between candidates that pass the principles
• cultural-references.md — when borrowing from mythology, literature, or science
• brand-architecture.md — if naming within a brand family
• language-rules.md — when using foreign words or non-English source languages. Covers pronunciation accessibility, cross-language meaning checks, diacritics, transliteration, and the exoticism trap
• case-studies.md — real product naming examples by technique
• languages/INDEX.md — if the naming brief targets a non-English language or multilingual audience. Check the index for available locale files, load the relevant one(s), and use its phonosemantic rules, word formation patterns, and cultural conventions instead of the English defaults

Step 4: Filter (internal)

Apply the anti-pattern checklist and evaluation criteria to cut candidates down to ~10 semifinalists. Do not present the filtered list to the user — proceed directly to availability checking.

Load these references:

• anti-patterns.md — patterns that kill names
• evaluation.md — scoring rubric and comparison framework

Step 5: Availability Gate (internal, MANDATORY)

This step is blocking. Do NOT skip it. Do NOT proceed to evaluation without completing it.

Check whether semifinalists are actually available. Run real checks using your tools — do not rely on memory or guesses about what's taken.

Load availability.md for the full checking workflow and decision framework.

What to check is determined by the naming brief (Step 1, question 6). The user told you which platforms matter. Use that answer to decide which checks are mandatory vs. nice-to-have. Refer to the "Availability Decision Framework" table in availability.md to prioritize.

Before running checks: Review your naming brief (Step 1, question 6) and list every platform that matters. Map each to the script's platform argument. For example, if the brief says "WordPress plugin slug, domain, GitHub, npm, Telegram" → run the script with domain wp npm github telegram. Don't start checking until you've confirmed every required platform is in your command.

Required actions for EVERY semifinalist:

1. Prior-art / competitor conflict search FIRST (this is the most-skipped, most-fatal step):

Do this before any domain or platform checks — it's the most common kill reason, and running availability checks on names that will be killed by prior art wastes effort. A free npm/GitHub handle does NOT mean the name is clear — a registry handle being available says nothing about a prominent product already using that word. You must look at what exists, not just whether the slug is taken.

Run ALL THREE, for every semifinalist:

• GitHub by name, by stars: https://api.github.com/search/repositories?q=[name]+in:name&sort=stars — read the TOP result's description + star count. A high-star repo using this exact name is a prior-art hit even if the org slug is free.
• Web search: "[name]" [product category], "[name]" software, "[name]" company, and "[name]" AI — look for an established company/product/tool, not just a dictionary definition.
• Trademark (availability.md §5): quick USPTO/EUIPO pass for anything headed to market.

Kill / demote rules:

• Same category (direct competitor) → DEAD. Drop immediately.
• Same namespace + same audience → DEAD for OSS/dev tooling, even if it's not a direct competitor. Example: naming a brand-genesis dev tool "Kiln" when Kiln-AI/Kiln (4.9k★, an AI-systems tool) exists — different product, but the same audience installs both from the same ecosystem, so search/discovery is permanently poisoned. For a tool whose entire point is a discovery funnel, this is disqualifying.
• Large brand in an unrelated industry → usable but penalized. You'll fight for search forever (see availability.md §21). Weigh it; don't pick it by default.

Anti-pattern (learned 2026-06-16, Kiln dogfood): checking npm/gh-user/dns for a free handle and calling the name "available" WITHOUT the three prior-art searches above. The handle was free; the name was owned by a 4.9k★ AI tool in the same audience. Handle-availability ≠ prior-art-clear.

2. Domain and platform checks for survivors:

Dictionary word shortcut: If a candidate is a common English dictionary word (single word, commonly known), skip exact-match TLD checks (.com, .dev, .io, .app, .co) — they are taken. Go directly to prefix variants (get[name].com, use[name].com), suffix variants ([name]dev.com, [name]guide.com), and alternative TLDs (.site, .sh). Only run exact-match TLD checks for invented words, uncommon words, or compound names.

Use the bundled availability script for fast batch checking. It lives at scripts/check-availability.sh relative to this skill's directory:

# In Claude Code, ${CLAUDE_SKILL_DIR} expands to this skill's directory. In other
# agents, resolve scripts/check-availability.sh relative to where this SKILL.md was loaded.
bash ${CLAUDE_SKILL_DIR}/scripts/check-availability.sh [name] domain npm github pypi telegram

Pass only the platforms relevant to the naming brief. Run it for each surviving semifinalist. The script checks domain (whois for .com/.dev/.io), npm, PyPI, GitHub org, crates.io, RubyGems, WP plugin slug, and Telegram.

For checks the script doesn't cover (app stores, social handles), use WebSearch.

Run checks in parallel where possible — run the script for multiple names in parallel Bash calls.

3. Domain checks (Bash — whois):

• At minimum check .com and the most relevant TLD for the product type
• Bash: whois [name].com 2>&1 | grep -iE "no match|not found|no data found|available" — match = available
• If whois is not installed or fails, fall back to: curl -s -o /dev/null -w "%{http_code}" https://[name].com — but note this only checks if a site is live, not domain registration
• If exact .com is taken, also check prefix variants: whois get[name].com, whois use[name].com

4. Platform-specific checks (based on naming brief):

Run whichever of these the naming brief requires:

Platform	How to check
npm	Bash: npm view [name] 2>&1 — "not found" = available
PyPI	Bash: curl -s -o /dev/null -w "%{http_code}" https://pypi.org/project/[name]/ — 404 = available
GitHub org	Bash: curl -s -o /dev/null -w "%{http_code}" https://github.com/[name] — 404 = available
GitHub repo	Bash: gh repo view [org]/[name] 2>&1 — "not found" = available
crates.io	Bash: curl -s -o /dev/null -w "%{http_code}" https://crates.io/api/v1/crates/[name] — 404 = available
RubyGems	Bash: curl -s -o /dev/null -w "%{http_code}" https://rubygems.org/api/v1/gems/[name].json — 404 = available
WP plugin slug	Bash: curl -s "https://api.wordpress.org/plugins/info/1.2/?action=plugin_information&slug=[name]" — "Plugin not found" in response = available
Telegram	Bash: curl -s -o /dev/null -w "%{http_code}" https://t.me/[name] — 404 = available
App stores	WebSearch: "[name]" site:apps.apple.com or "[name]" site:play.google.com
Social handles	WebSearch: site:x.com/[name], site:instagram.com/[name]

5. Decision gate:

• Drop candidates that fail critical availability checks (direct competitor, trademark conflict, multiple must-have platforms unavailable)
• Flag but keep candidates where the name is strong enough to justify workarounds (e.g., exact .com taken but get[name].com is free)
• If fewer than 3 candidates survive, go back to Step 3 and generate more — do NOT lower the bar

Only candidates that pass this gate proceed to Step 6.

Step 6: Evaluate & Compare (internal)

Score the surviving candidates against weighted criteria. Run contextual sentence tests. Compare side-by-side.

Load evaluation.md for the full framework.

Step 7: Present & Decide (first user-facing output)

This is the first time the user sees any name candidates. Present top 3-5 candidates with:

• The name
• Origin story (15-second version)
• Why it works (which principles it satisfies)
• Availability status (which platforms are confirmed available, which need workarounds)
• Any risks or trade-offs
• Tagline suggestions (see taglines.md for guidance)

Recommend the user sit with finalists for 24 hours before deciding.

When to Loop Back

The process is not strictly linear. Loop back when:

• All candidates fail anti-patterns (Step 4): Go to Step 2 — you need new metaphor territories, not more names from exhausted territories.
• Fewer than 3 survive availability (Step 5): Go to Step 3 — generate more candidates in the surviving territories.
• No candidate scores above 70 (Step 6): Go to Step 2 — the metaphor foundation isn't strong enough.
• User rejects all finalists (Step 7): Go to Step 1 — revisit the naming brief. Maybe the constraints, tone, or audience assumptions need adjusting.

Don't keep pushing weak names forward. Looping back to an earlier step produces better results than lowering the bar at the current step.

Reference Files

File	When to load
principles.md	Foundational gates — load first when generating or evaluating. Every candidate must pass these.
phonosemantics.md	Refinement — sound-matching for choosing between candidates that pass the principles
anti-patterns.md	When filtering candidates
metaphor-mapping.md	When exploring conceptual territories
cultural-references.md	When considering mythology, literature, or science references
brand-architecture.md	When naming within a product family
language-rules.md	When using foreign words or non-English source languages
availability.md	When checking platform availability
case-studies.md	When studying real-world naming examples
evaluation.md	When scoring and comparing finalists
languages/INDEX.md	When naming for a non-English audience — see index for available languages
industries/INDEX.md	When naming for a specific industry — see index for available guides
open-source.md	When naming an open source project — CLI, registry, and community constraints
taglines.md	When crafting taglines for finalists

Key Rules

1. Never generate names before establishing context. Always start with the naming brief.
2. Never rely on a thesaurus. Use metaphor exploration instead.
3. Work autonomously through Steps 3-6. Do not show raw candidates, unfiltered lists, or intermediate results. The user sees only the final vetted, scored, availability-checked candidates in Step 7.
4. Flag AI slop immediately. If a candidate matches anti-patterns, call it out.
5. Never present names without availability checks. Every finalist must have real, tool-verified availability status. No guessing from memory. Run the checks.
6. Never present names without origin stories. Every name must have a "why."
7. Quality over quantity in finals. Present 3-5 strong candidates, not 20 mediocre ones.
8. Respect the user's taste. If they reject a direction, don't push it — explore a different territory.
9. Brand-grade ≠ verbable. Category-defining brands (Notion, Obsidian, Figma, Linear) are evocative nouns with a concrete metaphor, NOT verbs. If the brief is "compete with [category king]", optimize for gravitas + a drawable metaphor; don't force verbability. The action-verb stays generic (GitHub + "push", Vercel + "deploy"); a brand-verb is earned through usage, never designed in.