polish-repo-naming

polish-repo-naming is a command for Claude Code from axiomantic/spellbook. It costs 17 tokens per session (2,196 once invoked), scanned A, original, MIT.

A workshop step for improving an open-source project’s name, tagline, and positioning. Positioning explains who the project is for and how it differs from alternatives.

In plain words
What is it for?
Use it after project discovery or an audit to develop name and tagline recommendations with supporting reasons.
Why use it?
It helps a project communicate its purpose clearly and avoid naming conflicts across package registries, code hosts, and search engines.

Command for Claude Code

Written for Claude Code: a Claude Code command (commands/*.md). Also seen: names the AskUserQuestion tool.

Good fit Use it after project discovery or an audit to develop name and tagline recommendations with supporting reasons.

Compare 6 commands from other repositories ↓
Install with agentmods
npx agentmods add commands/axiomantic/spellbook/polish-repo-naming
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/axiomantic/spellbook

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for polish-repo-naming

README.md
[![agentmods](https://agentmods.dev/badge/commands/axiomantic/spellbook/polish-repo-naming/github.svg)](https://agentmods.dev/commands/axiomantic/spellbook/polish-repo-naming)
Your own site
<a href="https://agentmods.dev/commands/axiomantic/spellbook/polish-repo-naming"><img src="https://agentmods.dev/badge/commands/axiomantic/spellbook/polish-repo-naming/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for polish-repo-naming

Your own site · 80×15
<a href="https://agentmods.dev/commands/axiomantic/spellbook/polish-repo-naming"><img src="https://agentmods.dev/badge/commands/axiomantic/spellbook/polish-repo-naming.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 17 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,196 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00017 $0.02196
Opus 5 $0.00009 $0.01098
Sonnet 5 $0.00003 $0.00439
Haiku 4.5 $0.00002 $0.00220

Measured 7d ago against content hash 708b54b496a8, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

polish-repo-naming scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

commands/polish-repo-naming.md · 196 lines

How it starts

The opening of the file, as written. The whole thing — 196 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Polish Repo - Naming and Positioning

ROLE

You are a naming consultant who has analyzed 25+ successful open source projects. You understand that a name is a permanent SEO decision and a tagline is a 60-character sales pitch. You back every recommendation with evidence from real projects.

Invariant Principles

  1. Name and tagline must cover different ground - if name is descriptive, tagline conveys differentiator; if name is abstract, tagline explains
  2. Never disparage competitors in positioning - imply replacement, don't name-and-shame
  3. Check for namespace collisions before recommending any name (PyPI, npm, GitHub, Google)
  4. Every recommendation includes rationale citing real projects

Prerequisites

  • Project discovery complete (what it does, who it's for, what's different)
  • If audit was run, scorecard available for naming/positioning scores

Process

Step 1: Project Understanding

If not already available from the audit, gather:

  • What does the project do? (one sentence)
  • Who is the target user? (role, not "developers")
  • What problem does it solve?
  • What are the alternatives? How is this different?
  • What ecosystem does it live in? (Python, JS, etc.)
  • What's the personality? (serious enterprise tool? playful CLI? pragmatic library?)

Use AskUserQuestion to collect any missing information before proceeding.

Step 2: Naming Workshop

Skip this step if the user has already settled on a name. Otherwise, present the naming taxonomy and generate candidates.

Naming Taxonomy

Present the following strategies with evidence:

Strategy Examples Best For Risk Level
Invented portmanteau Pydantic (Python+pedantic), Polars (polar+Rust), Streamlit (stream+lit), Gradio (gradient+IO) Best balance of memorable + Googleable + semantic hint. Safest for new projects. Low
Descriptive compound FastAPI, SQLModel, LangChain, NumPy Maximum clarity, minimum branding. Works when the domain IS the brand. Low
Modified word Typer (type+-er), Scrapy (scrape+-y), Ruff (rough/bark) Familiar yet distinct. Easy to remember. Low-medium
Real English word Rich, Black, Flask, Poetry, Celery, Requests Memorable, brandable. But SEO nightmare unless you achieve search dominance. "Black python" returns snakes. High
Abbreviation uv (ultraviolet) Short, punchy. But hard to Google ("uv python" needed), fragile in conversation. High
Proper noun/cultural reference Django (Django Reinhardt) Highest ceiling, highest risk. Only works if project becomes famous. Zero hint of purpose. Very high

Read the full file on GitHub · 196 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago First seen · 196 lines · 17 tokens per session scan A 708b54b496a8

Subscribe to this mod's changes

polish-repo-naming is a command published in the GitHub repository axiomantic/spellbook (10 stars, last pushed today), licensed MIT. It adds 17 tokens to every session and 2,196 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other commands, from other repositories

subagent-implementation

Orchestrate implement→review subagent loop until task complete. Reads the approved spec, writes a thin brief to .claude/.scratchpad/, dispatches fresh-context subagents, loops until reviewer signs off, commits per green iteration, then updates repo docs.

damusix/atomic-claude · 53 tokens

documentation

Bootstrap and maintain project documentation surfaces. Two modes: bootstrap (discover doc files, index them in CLAUDE.md) and authoring (scan for unindexed docs, match diff against indexed surfaces, walk stale/incomplete/missing items with Yes/Later/Remind/Skip).

damusix/atomic-claude · 0 tokens

watch-ci

Spawn a background Haiku-backed subagent to watch CI for the current branch (or specified target). Provider-agnostic — the subagent inspects project signals to identify the CI system (GitHub Actions, GitLab CI, CircleCI, etc.) and picks the right CLI. Returns immediately; reports back when CI reaches a terminal state.

damusix/atomic-claude · 69 tokens

session-report

Capture what changed this session and why, scoped to the current branch. Read by ship verbs when synthesizing the commit message; deleted after a successful commit.

damusix/atomic-claude · 31 tokens

integrate

Analyze and enhance AI artifacts to leverage Subcog memory effectively.

zircote/subcog · 12 tokens

maintain

Run automated maintenance — seeker finds bugs from pod logs and raises GitHub issues, fixer picks them up and creates PRs. Can run as a one-shot or scheduled via /schedule.

randomittin/heimdall · 40 tokens