domainstorm 0.3.0 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +9 -4
  2. package/SKILL.md +75 -0
  3. package/package.json +2 -1
package/README.md CHANGED
@@ -124,14 +124,19 @@ Output columns:
124
124
 
125
125
  ## OpenClaw / AI Agent Skill
126
126
 
127
- Domainstorm ships as an [OpenClaw](https://openclaw.ai) skill. Install it and any OpenClaw-powered agent will automatically use Domainstorm when you ask it to brainstorm or check domains.
127
+ Domainstorm ships as an [OpenClaw](https://openclaw.ai) skill. Install it with a single `npx` command no global install needed:
128
128
 
129
129
  ```bash
130
- # Install the skill (from ClaHub or local)
131
- openclaw skill install domainstorm
130
+ npx domainstorm --install-skill
132
131
  ```
133
132
 
134
- Or drop the [`SKILL.md`](https://github.com/tanishqsh/domain-cli/blob/main/skill/SKILL.md) into your `~/.openclaw/workspace/skills/domainstorm/` directory manually.
133
+ This launches an interactive installer that lets you pick where to install the skill (Claude Code, OpenClaw, Cursor, or a custom path). Once installed, your agent will automatically use Domainstorm when you ask it to brainstorm or check domains.
134
+
135
+ You can also print the skill file to stdout for manual setup:
136
+
137
+ ```bash
138
+ npx domainstorm --skill
139
+ ```
135
140
 
136
141
  Works with any agent that supports OpenClaw skills — Claude, Codex, Cursor, and others.
137
142
 
package/SKILL.md ADDED
@@ -0,0 +1,75 @@
1
+ ---
2
+ name: domainstorm
3
+ description: Brainstorm and check domain name availability from the terminal. Use when the user asks to find available domains, brainstorm domain names, check if a domain is taken, or needs naming ideas for a project, startup, product, or tool. Also use when domain shopping, comparing TLDs, or building a list of available domains for purchase.
4
+ ---
5
+
6
+ # Domainstorm
7
+
8
+ Domain brainstorming and availability checking via CLI. Zero install — runs via `npx`.
9
+
10
+ ## Quick Start
11
+
12
+ ```bash
13
+ # Brainstorm + check availability
14
+ npx domainstorm --brainstorm "seed words here" --tld com --only-available --table
15
+
16
+ # Check specific domains
17
+ npx domainstorm example.com coolname.xyz agent.md
18
+
19
+ # Check from file
20
+ npx domainstorm --input domains.txt --output results.csv
21
+ ```
22
+
23
+ ## Key Flags
24
+
25
+ | Flag | Purpose | Default |
26
+ |------|---------|---------|
27
+ | `--brainstorm "seeds"` | Generate domain ideas from seed words | — |
28
+ | `--tld <tld>` | Default TLD for bare labels | `md` |
29
+ | `--only-available` | Show only available domains | off |
30
+ | `--table` | Structured table output | off |
31
+ | `--plain` | Machine-friendly TSV output | off |
32
+ | `--max-suggestions <n>` | Max brainstormed candidates | `120` |
33
+ | `--input <file>` | Read domains from file (one per line) | — |
34
+ | `--output <file>` | Export results to CSV | — |
35
+ | `--server <host>` | WHOIS server override (e.g. `whois.nic.md`) | auto |
36
+ | `--dns-prefilter` | DNS pre-check before WHOIS (faster) | off |
37
+ | `--concurrency <n>` | Parallel WHOIS requests | `2` |
38
+ | `--raw` | Include WHOIS snippet in output | off |
39
+
40
+ ## Output Format
41
+
42
+ Each domain returns:
43
+ - **Verdict**: `✅ AVAILABLE`, `❌ TAKEN`, or `⚠️ UNKNOWN`
44
+ - **Domain**: the checked domain
45
+ - **Whois**: `registered`, `likely_available`, or `unknown`
46
+ - **Risk**: `low` or `high_tm_risk`
47
+ - **Story**: brainstorm narrative (e.g. "Two-seed compound", "Seed acronym")
48
+
49
+ Summary line: `✅ X available, ❌ Y taken, ⚠️ Z unknown.`
50
+
51
+ ## Common Patterns
52
+
53
+ ```bash
54
+ # .com domains for a startup idea
55
+ npx domainstorm --brainstorm "fintech payments" --tld com --only-available --table
56
+
57
+ # .md domains (agent/dev ecosystem)
58
+ npx domainstorm --brainstorm "agent mcp runtime" --tld md --server whois.nic.md --only-available --table
59
+
60
+ # .xyz domains
61
+ npx domainstorm --brainstorm "crypto defi wallet" --tld xyz --only-available --table
62
+
63
+ # Check a single domain
64
+ npx domainstorm coolproject.com
65
+
66
+ # Bulk check from file, export CSV
67
+ npx domainstorm --input candidates.txt --output results.csv --dns-prefilter
68
+ ```
69
+
70
+ ## Notes
71
+
72
+ - WHOIS results are heuristic — always confirm at registrar checkout before purchasing.
73
+ - Registries rate-limit bulk lookups. Retry `⚠️ UNKNOWN` results after a cooldown.
74
+ - Use `--dns-prefilter` for faster checks (skips WHOIS for domains that resolve via DNS).
75
+ - No API keys needed. No config. Just `npx`.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "domainstorm",
3
- "version": "0.3.0",
3
+ "version": "0.3.2",
4
4
  "description": "Brainstorm and check domain names in one command.",
5
5
  "repository": {
6
6
  "type": "git",
@@ -18,6 +18,7 @@
18
18
  "files": [
19
19
  "check-domains.mjs",
20
20
  "agent-candidates.txt",
21
+ "SKILL.md",
21
22
  "README.md"
22
23
  ],
23
24
  "scripts": {