clusterlisted

# `/cluster` — Topic cluster planner Plans a complete topic cluster around a seed keyword: pillar page + N cluster pages + the internal-linking graph + wireframes for every page. Topical authority is built at cluster granularity, not single-post granularity — and this skill is what makes that engineering possible inside the toolkit. ## Inputs Required (asked at start if not given): - **Seed keyword** — the broad topical anchor. Examples: "ai consultant" (site-a), "spanish catering houston" (site-b), "endocrinologist houston" (site-c). - **Site** — must match a folder under `sites/[name]/`. The skill reads its `site-info.md`. Optional (per-run overrides): - **`--max-clusters=N`** — caps the cluster count (default 8; valid range 3–15). Lower → faster ship; higher → fuller topical authority but more downstream content to write. - **`--include-bottom-funnel`** — when set, includes commercial-intent clusters (pricing, vs-competitor, alternative) alongside informational ones. Default: informational-only. - **Keyword tool** — overrides the site's default (SEMrush, GSC, Ahrefs, manual SERP analysis). Defaults to `site-info.md` → `Keyword tool`. ## Workflow ### Step 0 — Cron-mode detection (if invoked with `--cron`) If the invocation contains `--cron`, this skill runs in cron mode (no user available). Required behavior: 1. **Idempotency check:** see this skill's "Routine versioning + idempotency contract" section. If today's output already exists at `_drafts/cluster-{seed-slug