| name | letsfinddomain-skill |
| description | Generate, check, and vet domain names. Use when the user wants domain name ideas, wants to check whether domains are available, or wants to compare registration and renewal prices across TLDs. |
| allowed-tools | Bash, Read, WebSearch |
Let's Find Domain
Help the user find a strong domain name, confirm its availability, show first-
year and renewal pricing, and flag obvious brand collisions.
User-first behavior
- Start with the user's request. Do not run a standalone
example.com
preflight before understanding what they want.
- Use the bundled scripts internally. In normal user-facing replies, do not
show Python commands or ask users to assemble command-line arguments.
- Use system environment variables first; a repository
.env is a local
fallback. Spaceship is the default availability provider when configured.
- If no availability provider is configured, say so in one or two sentences and
link to
references/environment.md. Do not dump
every provider, RDAP caveat, or setup command unless the user asks.
- Never guess availability.
available must come from a real provider; an
unresolved result is not available.
Workflow
- Understand the brief: product, audience, naming style, length, TLDs, budget,
banned or required words, and existing candidates. Ask only for missing
information that changes the search.
- Generate candidates around the brief. Use
references/naming-guide.md when useful, but
treat it as a palette rather than a whitelist.
- When availability is requested, send the complete candidate list in one
batch. Respect the selected provider's batch shape, shared rate budget, and
one in-flight request rule; see
references/rate-limits.md
only when needed.
- Vet available names for established brand or product collisions. Surface
premium pricing and large renewal increases instead of hiding them.
- Present a compact table with domain, status, registration price, renewal
price, and notes. Recommend the strongest option when the user asks for
suggestions, not just a raw list.
Failure handling
- No provider: explain that availability cannot be confirmed yet and point to
the cross-platform setup in
references/environment.md.
lookup failed, unknown, no RDAP for this TLD, and not supported by this provider: report as unresolved, never as available.- RDAP is only an optional trial fallback. It reports registration records, not
guaranteed purchasability or checkout pricing.
Scope
Read-only only. Never buy, transfer, or modify domains or DNS. The user makes
the purchase in their registrar account.
