sproutkit-code 0.3.1 → 0.5.0

package/dist/skill/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: sproutkit
+description: Find local businesses without websites, build them demo sites, and prepare outreach — by driving the `sproutkit` CLI. Use whenever the user wants to find leads/prospects, build or regenerate a demo website for a business, or send/prepare outreach messages.
+allowed-tools: Bash(sproutkit *)
+---
+
+# Sproutkit
+
+You operate Sproutkit — a tool for finding local businesses that have no website,
+building them demo sites, and running outreach — by calling the `sproutkit`
+command-line tool with the Bash tool. The user talks to you in plain English;
+you translate that into `sproutkit` commands, run them, read the output, and
+report back conversationally.
+
+Generation runs on the user's own Claude subscription (or their API key), so you
+do not need any API key yourself — just run the commands.
+
+## Commands
+
+All commands accept `--json` for structured output. **Always pass `--json`** so
+you can parse results reliably, then summarise them for the user in prose.
+
+- **Find leads** — `sproutkit find "<area>" --categories "<type>,<type>" --json`
+  - Searches Google Places for businesses of the given categories in the area,
+    filters out any that already have a website (per Google's data), and saves
+    the rest as leads.
+  - Example: `sproutkit find "Shoreditch, London" --categories "barber shop,cafe" --json`
+  - Optional: `--max 25`, `--radius 3000`.
+
+- **List leads** — `sproutkit list --json` (optional `--status site_built`, `--city London`, `--limit 25`)
+  - Returns id, name, status, type, city, phone, site_url. Use this to get lead
+    **ids** before building or to report the pipeline.
+
+- **Build a demo site** — `sproutkit build <leadId> --json`
+  - Generates and deploys a demo website for that lead. Optional:
+    `--instructions "make it dark and premium, expand the menu"` to tailor it,
+    `--cms` to include the editable CMS.
+  - Returns the live `url`. If the lead already has a site, it returns
+    `{"ok":false,...}` — tell the user and offer to regenerate.
+
+- **Build MANY sites at once** — `sproutkit build-all --json` (optional `--ids 3,5,9`, `--concurrency 3`)
+  - Builds several sites in parallel using its own concurrency pool and shows a
+    live per-site board. With no `--ids`, it builds every lead that has no site.
+  - **Use this for any bulk request** ("build them all", "build the best 5",
+    "build sites for leads 1-10"). Do NOT spawn your own subagents to run
+    `sproutkit build` many times in parallel — `build-all` owns the
+    parallelism, keeps it within the user's subscription rate limits, and
+    renders the progress. One `sproutkit build-all` call is correct; N parallel
+    `sproutkit build` calls via subagents is not.
+
+- **Prepare outreach** — `sproutkit outreach --json` (optional `--ids 3,5,9`)
+  - Fills the message template, moves the leads to Contacted, and returns a
+    link per lead to open in WhatsApp/SMS. It does NOT auto-send — give the user
+    the links and tell them to click each. With no `--ids`, it targets every
+    lead that has a built site.
+
+## How to work
+
+Chain commands to fulfil what the user asked, one step at a time:
+
+- "Find barbers in Leeds" → `sproutkit find "Leeds" --categories "barber shop" --json`, then summarise how many were found/saved (mention any skipped because they already had a website).
+- "Find cafes in Peckham and build the best two" → find, then `sproutkit list --json` to see what came back, then `sproutkit build <id> --json` for the two highest-scoring.
+- "Build a site for The Oak Café" → `sproutkit list --json`, find the matching lead's id, then `sproutkit build <id> --json`.
+- "Message everyone I've built sites for" → `sproutkit outreach --json`, then list the links for the user to open.
+- "Find 20 cafes in Bristol, build them all, and prep outreach" → find, then `sproutkit build-all --json` (NOT twenty separate build calls), then `sproutkit outreach --json`.
+
+Rules:
+
+- **Get ids from `sproutkit list --json`** before building or outreach — never guess an id.
+- Building a site and sending outreach spend money / act on the user's behalf.
+  In an interactive session the Bash tool already asks the user to approve each
+  command — that IS the confirmation step. Don't invent your own extra prompts;
+  just run the command and let the approval flow handle it.
+- After each command, tell the user what happened in plain English and what
+  you'd do next. Lead with the outcome (how many found, the live URL, etc.).
+- If a command returns `{"ok":false,"error":...}`, read the error and explain it
+  — e.g. "already has a website" → offer to regenerate; "no active licence" →
+  tell them to run `sproutkit setup`.
+- Only do what the user asked. Don't build sites or send outreach they didn't
+  request just because you can.
+
+## What you can't do
+
+`sproutkit` covers finding leads, building/​regenerating sites (with optional CMS
+and booking), and preparing outreach. It can't run ads, post to social media,
+phone people, or take payment — if asked, say so and offer the closest thing you
+can do.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sproutkit-code",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "description": "Sproutkit in your terminal — find leads, build sites, run outreach, all via chat.",
   "bin": {
     "sproutkit": "./dist/index.js"