Initial commit

commands/audit-site.md

@@ -0,0 +1,32 @@
+---
+name: audit-site
+description: Runs a technical SEO audit covering crawlability, indexation, and performance.
+usage: /seo:audit-site --domain example.com --scope "core pages" --depth 3
+---
+
+# Command: audit-site
+
+## Inputs
+- **domain** – root domain or subdomain to audit.
+- **scope** – optional focus (core pages, blog, docs, regional site).
+- **depth** – crawl depth (default 3 levels).
+- **include_logfiles** – flag indicating whether log files are available.
+
+## Workflow
+1. **Crawl Setup** – configure crawler (user agent, JS rendering, throttling) and run sample crawl.
+2. **Issue Detection** – flag broken links, duplicate content, redirect chains, orphan pages, sitemap gaps.
+3. **Technical Checks** – review Core Web Vitals, structured data coverage, hreflang, canonical tags, robots directives.
+4. **Indexation Review** – compare sitemap vs Search Console coverage, identify noindex/blocked assets.
+5. **Action Plan** – prioritize fixes with owners, dependencies, and estimated effort.
+
+## Outputs
+- Audit summary deck and spreadsheet with severity scoring.
+- Ticket-ready backlog grouped by theme (performance, crawlability, content, infra).
+- Monitoring recommendations (alerts, dashboards, regression tests).
+
+## Agent/Skill Invocations
+- `technical-seo-lead` – leads crawl and action plan.
+- `technical-seo` skill – provides diagnostic templates and remediation references.
+- `keyword-research` skill – aligns technical fixes with priority keyword clusters when relevant.
+
+---

commands/build-keyword-strategy.md

@@ -0,0 +1,32 @@
+---
+name: build-keyword-strategy
+description: Generates intent-based keyword clusters and prioritization for SEO roadmaps.
+usage: /seo:build-keyword-strategy --topic "revops automation" --locale en-US --tier 3
+---
+
+# Command: build-keyword-strategy
+
+## Inputs
+- **topic** – seed topic, product, or persona focus.
+- **locale** – market/language (default en-US).
+- **tier** – optional priority (1 = must-win, 3 = explore).
+- **competitors** – optional competitor domains for SERP gap analysis.
+
+## Workflow
+1. **Seed Expansion** – build keyword universe via semantic expansion + intent variants.
+2. **Classification** – bucket by funnel stage, search intent, and pillar vs cluster.
+3. **Scoring** – attach volume, difficulty, SERP features, click potential.
+4. **Gap Analysis** – compare against existing URLs + competitor coverage.
+5. **Roadmap** – prioritize clusters with recommended owners, assets, and deadlines.
+
+## Outputs
+- Keyword cluster table (term, intent, volume, KD, current URL, opportunity).
+- Pillar/cluster mapping visual (mermaid or table).
+- Action plan with sprint-ready tasks.
+
+## Agent/Skill Invocations
+- `seo-architect` – oversees strategy and architecture.
+- `keyword-research` skill – supplies research frameworks and quality gates.
+- `technical-seo-lead` – validates feasibility for new pillar structures.
+
+---

commands/optimize-page.md

@@ -0,0 +1,32 @@
+---
+name: optimize-page
+description: Audits and enhances an existing page for target keywords, UX, and conversion goals.
+usage: /seo:optimize-page --url https://example.com/guide --target "sales enablement platform"
+---
+
+# Command: optimize-page
+
+## Inputs
+- **url** – page to audit.
+- **target** – primary keyword or topic.
+- **secondary_terms** – optional supporting keywords.
+- **goal** – conversion goal (lead, signup, demo) to align CTAs.
+
+## Workflow
+1. **Baseline Snapshot** – capture current rankings, traffic, SERP snippet, schema.
+2. **Gap Analysis** – compare page structure vs ranking competitors, search intent alignment.
+3. **Optimization Plan** – recommend updates for title/meta, headings, copy depth, media, CTAs, internal links.
+4. **Technical Check** – validate core web vitals, structured data, mobile usability.
+5. **Measurement Plan** – document KPIs, publish date, refresh reminders.
+
+## Outputs
+- Optimization diff (table of recommended changes).
+- Updated metadata + structured data snippets.
+- Internal link recommendations and CTA experiments.
+
+## Agent/Skill Invocations
+- `content-optimizer` – crafts updated copy/brief.
+- `on-page` skill – enforces placement/checklists.
+- `technical-seo-lead` – ensures performance/schema compliance.
+
+---