taketomarket 2.2.0 → 2.3.0

package/skills/ttm-email-check/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: ttm-email-check
+description: >
+  Deliverability, dark-mode, and spam-trigger check for email assets.
+  Run before sending any email campaign.
+disable-model-invocation: true
+allowed-tools: Read Write Bash Grep
+---
+
+# /ttm-email-check
+
+Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/discipline/email-check.md`.
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-email-preflight/SKILL.md

@@ -1,19 +1,25 @@
 ---
 name: ttm-email-preflight
 description: >
-  Deliverability, dark-mode, and spam-trigger scan for email assets.
-  Use before sending any email campaign.
+  [DEPRECATED v2.3.0 -> removed v2.4.0] Renamed to /ttm-email-check.
 disable-model-invocation: true
-allowed-tools: Read Write Bash Glob Grep
+allowed-tools: Read
 ---
 
-# /ttm-email-preflight
+# /ttm-email-preflight (DEPRECATED)
 
-Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/discipline/email-preflight.md`
+Renamed to `/ttm-email-check` in v2.3.0.
 
-This command will:
-- Scan email content for spam trigger words and phrases
-- Check dark-mode rendering compatibility
-- Validate deliverability factors (subject line length, preheader, etc.)
-- Verify links, UTM parameters, and unsubscribe compliance
-- Generate a preflight report with pass/fail per check
+Print:
+
+```
+⚠️  /ttm-email-preflight is deprecated.
+   Use /ttm-email-check instead. Running /ttm-email-check now...
+```
+
+Invoke `Skill` tool with `skill: ttm-email-check`.
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-fix/SKILL.md

@@ -11,3 +11,8 @@ allowed-tools: Read Write Bash Glob Grep Task AskUserQuestion
 # /ttm-fix
 
 Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/lifecycle/fix.md`
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-health/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: ttm-health
 description: >
-  Validate .marketing/ directory integrity, reference file completeness,
+  Validate .taketomarket/ directory integrity, reference file completeness,
   and state consistency. Auto-triggers when potential issues detected.
 disable-model-invocation: false
 allowed-tools: Read Bash Glob Grep
@@ -10,3 +10,8 @@ allowed-tools: Read Bash Glob Grep
 # /ttm-health
 
 Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/utility/health.md`
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-humanize/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: ttm-humanize
+description: >
+  Mandatory final-step humanizer. Detects and rewrites AI writing patterns
+  (inflated symbolism, em-dash overuse, rule-of-three, AI vocab, passive voice,
+  filler phrases) and matches the user's voice from BRAND.md samples. Runs on
+  every audience-facing asset before write. Also runnable ad-hoc on any file or
+  pasted text.
+disable-model-invocation: false
+context: fork
+allowed-tools: Read Write Edit Grep Glob AskUserQuestion
+---
+
+# /ttm-humanize
+
+Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/lifecycle/humanize.md`.
+
+Required reading:
+- `${CLAUDE_PLUGIN_ROOT}/references/humanizer-patterns.md` -- pattern catalog.
+- `.taketomarket/BRAND.md` -- voice + tone + banned words.
+- `.taketomarket/POSITIONING.md` -- must-not-say.
+
+## Invocation modes
+
+**Mode A -- Auto (called by other skills):**
+Other producing skills call `/ttm-humanize` with the draft path as input. The skill rewrites in place and returns control.
+
+**Mode B -- Manual:**
+User runs `/ttm-humanize <file>` or pastes text. Skill rewrites and either writes back or prints the result.
+
+## Next steps
+
+Standard footer: see `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.

package/skills/ttm-icp-refresh/SKILL.md

@@ -17,3 +17,8 @@ This command will:
 - Propose ICP updates with evidence citations
 - Validate changes don't conflict with POSITIONING.md
 - Update ICP.md with human approval gate
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-improve-skill/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: ttm-improve-skill
+description: >
+  File a GitHub issue requesting changes to an existing takeToMarket skill.
+  Auto-uses gh CLI if installed and authed; otherwise opens a pre-filled
+  GitHub issue URL in your browser.
+disable-model-invocation: false
+allowed-tools: Read Bash AskUserQuestion Glob
+---
+
+# /ttm-improve-skill
+
+Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/utility/improve-skill.md`.
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-init/SKILL.md

@@ -1,12 +1,19 @@
 ---
 name: ttm-init
 description: >
-  Interview-driven onboarding that generates all .marketing/ reference files
-  from structured questioning. Use when setting up takeToMarket for a new project.
+  Interview-driven onboarding that generates .taketomarket/ reference files
+  (POSITIONING, BRAND, ICP, PRODUCT-DNA) with brand colors + logo. Supports
+  YOLO mode for non-critical question skipping. Use when setting up
+  takeToMarket for a new project.
 disable-model-invocation: true
-allowed-tools: Read Write Bash Glob Grep AskUserQuestion
+allowed-tools: Read Write Edit Bash Glob Grep AskUserQuestion
 ---
 
 # /ttm-init
 
 Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/setup/init.md`
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-keyword-map/SKILL.md

@@ -1,19 +1,25 @@
 ---
 name: ttm-keyword-map
 description: >
-  Generate keyword cluster map with intent tags. Use for content planning
-  and SEO strategy development.
+  [DEPRECATED v2.3.0 -> removed v2.4.0] Merged into /ttm-seo keyword-map.
 disable-model-invocation: true
-allowed-tools: Read Write Bash Glob Grep
+allowed-tools: Read
 ---
 
-# /ttm-keyword-map
+# /ttm-keyword-map (DEPRECATED)
 
-Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/discipline/keyword-map.md`
+Merged into `/ttm-seo keyword-map` in v2.3.0.
 
-This command will:
-- Generate keyword clusters from seed terms and competitor analysis
-- Tag each cluster with search intent (informational, navigational, transactional)
-- Map clusters to campaign topics and content types
-- Prioritize clusters by opportunity and alignment with positioning
-- Output a structured keyword map for campaign planning
+Print:
+
+```
+⚠️  /ttm-keyword-map is deprecated.
+   Use /ttm-seo keyword-map [seed-keyword] instead. Running /ttm-seo keyword-map now...
+```
+
+Invoke `Skill` tool with `skill: ttm-seo`, args: `keyword-map` plus any user-passed args.
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-landing/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: ttm-landing
+description: >
+  Scaffold + design + write copy for a Next.js marketing site (home, product,
+  pricing, about) using your brand colors, positioning, and PRODUCT-DNA.
+  Produces SSR + SSG site ready to deploy via /ttm-deploy. Use after /ttm-init
+  is complete.
+disable-model-invocation: true
+allowed-tools: Read Write Bash Glob Grep AskUserQuestion
+---
+
+# /ttm-landing
+
+Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/site/landing.md`.
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-learn/SKILL.md

@@ -12,3 +12,8 @@ allowed-tools: Read Write Bash Glob Grep AskUserQuestion
 # /ttm-learn
 
 Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/lifecycle/learn.md`
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-linkedin-post/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: ttm-linkedin-post
+description: >
+  Generate a LinkedIn post in your voice. First run interviews you for 2-5
+  author profiles to mimic, scrapes their recent posts via Playwright MCP,
+  and builds .taketomarket/PLAYBOOKS/linkedin-base.md. Subsequent runs use
+  that base + post history + news web search to draft posts. Final draft
+  passes through /ttm-humanize before output.
+disable-model-invocation: true
+allowed-tools: Read Write Bash Glob Grep AskUserQuestion WebSearch
+---
+
+# /ttm-linkedin-post
+
+Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/channel/linkedin-post.md`.
+
+## Flags
+
+- `--rebuild-base` — re-interview + re-scrape authors to refresh linkedin-base.md.
+- `--no-news` — skip the news web search.
+- `--topic <text>` — seed topic for this post.
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-measure/SKILL.md

@@ -12,3 +12,8 @@ allowed-tools: Read Write Bash Glob Grep
 # /ttm-measure
 
 Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/lifecycle/measure.md`
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-new-campaign/SKILL.md

@@ -11,3 +11,8 @@ allowed-tools: Read Write Bash
 # /ttm-new-campaign
 
 Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/setup/new-campaign.md`
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-next/SKILL.md

@@ -10,3 +10,8 @@ allowed-tools: Read Bash Glob
 # /ttm-next
 
 Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/utility/next.md`
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-playwright-setup/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: ttm-playwright-setup
+description: >
+  Walk through installing Playwright MCP server + Chrome extension bridge.
+  Enables competitor-scan fallback, LinkedIn/Twitter author scraping, and
+  landing/pSEO visual + performance gates. Run once per machine.
+disable-model-invocation: true
+allowed-tools: Read Write Bash AskUserQuestion
+---
+
+# /ttm-playwright-setup
+
+Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/utility/playwright-setup.md`.
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-positioning-check/SKILL.md

@@ -17,3 +17,8 @@ This command will:
 - Calculate positioning drift percentage and categorize drift types
 - Perform bleeding analysis (where positioning leaks into wrong territory)
 - Report findings with 3 options: Correct, Accept+log, Escalate to shift
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-positioning-shift/SKILL.md

@@ -17,3 +17,8 @@ This command will:
 - Create a deprecation schedule for old positioning assets
 - Present the full change for human approval (mandatory gate)
 - Update POSITIONING.md only after approval
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-produce/SKILL.md

@@ -12,3 +12,8 @@ allowed-tools: Read Write Bash Glob Grep Task
 # /ttm-produce
 
 Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/lifecycle/produce.md`
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-pseo/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: ttm-pseo
+description: >
+  Generate programmatic SEO routes (blog, use-case, comparison, alternative)
+  inside your existing /ttm-landing site. Each template has dedicated anatomy
+  and content playbook. JSON CMS input drives generation. AEO + SEO optimized.
+disable-model-invocation: true
+allowed-tools: Read Write Bash Glob Grep AskUserQuestion
+---
+
+# /ttm-pseo
+
+Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/site/pseo.md`.
+
+## Subcommands
+
+- `/ttm-pseo new <template> <slug>` — create a single new page.
+- `/ttm-pseo from-json <template> <path-to-json>` — create N pages from JSON array.
+- `/ttm-pseo list` — list all pSEO routes in site.
+
+Where `<template>` is one of: blog, use-case, comparison, alternative.
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-repurpose/SKILL.md

@@ -18,3 +18,8 @@ This command will:
 - Produce each derivative in a fresh context (wave-parallel)
 - Verify each derivative through the full quality gate wall
 - Track all derivatives as linked assets in the campaign
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-request-skill/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: ttm-request-skill
+description: >
+  File a GitHub issue requesting a new takeToMarket skill. Auto-uses gh CLI
+  if installed and authed; otherwise opens a pre-filled GitHub issue URL in
+  your browser.
+disable-model-invocation: false
+allowed-tools: Read Bash AskUserQuestion
+---
+
+# /ttm-request-skill
+
+Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/utility/request-skill.md`.
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-research/SKILL.md

@@ -1,13 +1,25 @@
 ---
 name: ttm-research
 description: >
-  Discover phase: perform market and audience research including SERP analysis,
-  competitor content audit, and ambient narrative mapping. Use after creating a campaign.
-argument-hint: "[campaign-slug]"
+  [DEPRECATED v2.3.0 -> removed v2.4.0] Renamed to /ttm-discover.
 disable-model-invocation: true
-allowed-tools: Read Write Bash Glob Grep
+allowed-tools: Read
 ---
 
-# /ttm-research
+# /ttm-research (DEPRECATED)
 
-Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/lifecycle/research.md`
+This skill was renamed to `/ttm-discover` in v2.3.0 and will be removed in v2.4.0.
+
+Print to user:
+
+```
+⚠️  /ttm-research is deprecated.
+   Use /ttm-discover instead. Running /ttm-discover now...
+```
+
+Then invoke the `Skill` tool with `skill: ttm-discover` and pass through any arguments.
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-resume/SKILL.md

@@ -11,3 +11,8 @@ allowed-tools: Read Write Bash Glob
 # /ttm-resume
 
 Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/utility/resume.md`
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-review/SKILL.md

@@ -11,3 +11,8 @@ allowed-tools: Read Write Bash Glob Grep AskUserQuestion
 # /ttm-review
 
 Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/lifecycle/review.md`
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-seo/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: ttm-seo
+description: >
+  Unified SEO + AEO toolkit. Subcommands: audit (URL/sitemap technical+content audit),
+  keyword-map (cluster generation with intent tags), aeo (citation status across AI engines).
+disable-model-invocation: true
+allowed-tools: Read Write Bash Glob Grep WebSearch WebFetch
+---
+
+# /ttm-seo
+
+## Step 0: First-run inline education
+
+Read `.taketomarket/CONFIG.md`. Parse `first_run_seen` (object) and `inline_education` (boolean, default true).
+
+If `inline_education` is false: skip this step. Else if `first_run_seen.ttm-seo` is not `true`, print the explainer below verbatim, then mark this skill as seen:
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/bin/ttm-tools.cjs" first-run mark ttm-seo
+```
+
+Use this exact check (bash) to decide whether to print: `node "${CLAUDE_PLUGIN_ROOT}/bin/ttm-tools.cjs" first-run check ttm-seo --raw` -- the JSON `seen` field is `true` once the explainer has run before.
+
+### Explainer for `/ttm-seo`
+
+`/ttm-seo` is the unified SEO + AEO toolkit. Subcommands: `audit`
+runs a URL or sitemap through technical and content checks;
+`keyword-map` generates a topic cluster with intent tags;
+`aeo` measures your citation status across Google AI Overviews,
+ChatGPT search, and Perplexity for a target query.
+
+Why it matters: SEO and Answer Engine Optimization (AEO) share most
+fundamentals -- structured content, clear claims, citation-worthy
+formatting -- but diverge on a few signals. Treating them as one
+toolkit with three modes prevents the trap of optimizing for Google
+in a way that breaks AEO citation.
+
+(Canonical source: `references/inline-education-blurbs.md`. Embedded verbatim because workflows do not @-resolve files at runtime.)
+
+---
+
+Routes to one of three subcommand workflows based on the first argument.
+
+## Usage
+
+```
+/ttm-seo audit <url-or-sitemap>     → workflows/discipline/seo/audit.md
+/ttm-seo keyword-map [seed-keyword] → workflows/discipline/seo/keyword-map.md
+/ttm-seo aeo <query>                → workflows/discipline/seo/aeo.md
+```
+
+## Workflow
+
+Parse first positional arg:
+- `audit` → read and follow `${CLAUDE_PLUGIN_ROOT}/workflows/discipline/seo/audit.md`
+- `keyword-map` → read and follow `${CLAUDE_PLUGIN_ROOT}/workflows/discipline/seo/keyword-map.md`
+- `aeo` → read and follow `${CLAUDE_PLUGIN_ROOT}/workflows/discipline/seo/aeo.md`
+- anything else: print usage and exit.
+- After matching a subcommand, strip it from `$ARGUMENTS` and forward the remainder to the workflow as the new `$ARGUMENTS` value. Example: `/ttm-seo audit https://example.com` → workflow receives `$ARGUMENTS=https://example.com`.
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-seo-audit/SKILL.md

@@ -1,20 +1,25 @@
 ---
 name: ttm-seo-audit
 description: >
-  Technical and content SEO audit of a URL or sitemap. Use for on-demand
-  SEO analysis of published content.
-argument-hint: "[url-or-sitemap]"
+  [DEPRECATED v2.3.0 -> removed v2.4.0] Merged into /ttm-seo audit.
 disable-model-invocation: true
-allowed-tools: Read Write Bash Glob Grep
+allowed-tools: Read
 ---
 
-# /ttm-seo-audit
+# /ttm-seo-audit (DEPRECATED)
 
-Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/discipline/seo-audit.md`
+Merged into `/ttm-seo audit` in v2.3.0.
 
-This command will:
-- Perform technical SEO analysis (meta tags, structure, schema markup)
-- Audit content SEO (keyword usage, headings, internal linking)
-- Check against SEO playbook best practices
-- Generate an actionable audit report with priorities
-- Suggest fixes aligned with positioning and campaign goals
+Print:
+
+```
+⚠️  /ttm-seo-audit is deprecated.
+   Use /ttm-seo audit <url-or-sitemap> instead. Running /ttm-seo audit now...
+```
+
+Invoke `Skill` tool with `skill: ttm-seo`, args: `audit` plus any user-passed args.
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-ship/SKILL.md

@@ -11,3 +11,8 @@ allowed-tools: Read Write Bash Glob Grep AskUserQuestion
 # /ttm-ship
 
 Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/lifecycle/ship.md`
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->

package/skills/ttm-state/SKILL.md

@@ -11,3 +11,8 @@ allowed-tools: Read Bash Glob
 # /ttm-state
 
 Read and follow the workflow at `${CLAUDE_PLUGIN_ROOT}/workflows/utility/state.md`
+
+## Next steps
+
+See `${CLAUDE_PLUGIN_ROOT}/templates/next-step-footer.md`.
+<!-- next-step-footer -->