letsfinddomain-skill

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

1. 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.
2. Generate candidates around the brief. Use references/naming-guide.md when useful, but treat it as a palette rather than a whitelist.
3. 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.
4. Vet available names for established brand or product collisions. Surface premium pricing and large renewal increases instead of hiding them.
5. 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.