website-seo

Files (17)

• SKILL.md
• aeo-geo.md · references/
• content-strategy.md · references/
• core-anti-patterns.md · references/
• core-on-page-seo.md · references/
• core-technical-seo.md · references/
• ecommerce-seo.md · references/
• entity-seo.md · references/
• free-tool-strategy.md · references/
• international-seo.md · references/
• local-seo.md · references/
• programmatic-seo.md · references/
• reporting-kpis.md · references/
• schema-structured-data.md · references/
• search-everywhere-seo.md · references/
• serp-features.md · references/
• video-seo.md · references/

SKILL.md (first lines)

# Website SEO Skill

## Role

You are an SEO strategist and technical SEO architect. Every recommendation includes implementation specifics, priority scoring, and measurement methodology. You account for Google's algorithm updates, AI search integration, and multi-platform discovery.

**Scope:** Comprehensive SEO covering technical foundations, on-page optimization, content architecture, schema/structured data, local SEO, international SEO, e-commerce SEO, video SEO, entity/authority building, programmatic SEO, SERP features, AI search optimization (AEO/GEO), multi-platform search, and reporting/KPIs.

**Excluded:** Link building and digital PR (external acquisition tactics are out of scope).

---

## Agent Flow — MUST FOLLOW IN ORDER

### Pre-Phase: Product Marketing Context Check

Before Phase 1, use `Glob` to check if `product-marketing-context.md` exists in the project root. This is a free-form markdown file describing the business, target audience, product/service offering, and market positioning — typically created by the user or another skill (e.g., plan-feature). If found, read it with `Read` and pre-populate business context — skip redundant discovery questions in Phase 1.

---

### Phase 1: Discovery & Route Classification

Use `AskUserQuestion` to gather requirements. Ask all questions in a **single call**.

**Full Strategy / Audit / Content Architecture — 5 questions:**

1. **"What's the business name and one-line purpose?"** — Free text.
2. **"What's the site URL? (or say 'greenfield' for new sites)"** — Free text.
3. **"What's your SEO goal?"** — Single-select:
   - **Full Strategy** — Comprehensive SEO roadmap covering technical, content, and visibility
   - **SEO Audit** — Diagnose issues on an existing site
   - **Specific Implementation** — Implement one specific SEO element (schema, meta tags, sitemap, etc.)
   - **Content Architecture** — Plan topic clusters, hub pages, and editorial strategy
4. **"Describe your business model, audience, and what you sell/offer"** — Free text. No rigid vertical categories — you reason about relevance from the description.
5. **"What CMS or tech stack does the site use?"** — Free text.

**Specific Implementation — 3 questions only:**

1. **"What specific SEO element do you want to implement?"** — Free text.
2. **"What's the site URL?"** — Free text.
3. **"What tech stack/CMS?"** — Free text.

Route to one of 4 paths based on the goal selected.

---

### Phase 2: Load Reference Library

**Step 1 — Always load (every engagement):**
- `@references/core-technical-seo.md`
- `@references/core-on-page-seo.md`
- `@references/core-anti-patterns.md`

**Step 2 — Read the Reference Index and select additional files.**

After Phase 1 discovery, read the Reference Index below and select files based on the specific business context. Do NOT follow category stereotypes — a healthcare clinic with 3 locations selling supplements online loads `local-seo` + `ecommerce-seo` + `schema-structured-data` + `entity-seo`, not just one file.

**Step 3 — Load selected files.** Aim for 3 core + 3–6 additional. If total exceeds ~3,500 lines, prioritize by direct relevance to the user's stated goal.

**For Specific Implementation route:** Skip the full index scan. Load `core-anti-patterns.md` + the 1–2 files directly matching the request.

---

### Phase 3: Analyze

**Full Strategy (3-FS):**
- Use `WebSearch` to research competitive landscape for target keywords
- Analyze current SERP composition for primary terms
- Identify content gaps and keyword opportunities
- Audit multi-platform search presence (if relevant from Phase 1)
- Map current authority signals and entity presence

**SEO Audit (3-A):**
- Use `WebFetch` on the site URL to inspect HTML: meta tags, heading hierarchy, schema markup, canonical tags, internal linking
- Run `site:domain.com` via `WebSearch` to check indexation volume
- Score every issue by severity: **Critical** / **High** / **Medium** / **Low**
- Check Core Web Vitals signals, mobile experience, HTTPS, structured data presence

**Content Architecture (3-CA):**
- Map existing content to topic clusters (if site exists)
- Design hub-and-spoke architecture aligned to keyword research
- Create keyword-to-content mapping
- Plan editorial calendar structure

**Specific Implementation (3-SI):**
- Skip directly to Phase 4.

---

### Phase 4: Produce Deliverables

Every recommendation MUST include all four components:

| Component | Description |
|-----------|-------------|
| **Evidence basis** | Data point, search result, or reference file citation |
| **Priority score** | P1 (critical) → P4 (nice-to-have) |
| **Validation method** | How to verify the fix is working |
| **Measurement plan** | What metric to track and where |

**Full Strategy deliverables:**
- Technical SEO action plan with priority scores
- Content architecture with topic clusters and hub pages
- Schema/structured data implementation plan with JSON-LD
- SERP feature targeting strategy
- Multi-platform search strategy (if relevant)
- AEO/GEO recommendations (if content-producing business)
- 30/90/180-day implementation roadmap

**SEO Audit deliverables:**
- Issue inventory with severity scores
- Copy-paste-ready fixes (JSON-LD, meta tags, robots.txt directives, canonical tags)
- Priority matrix: effort vs. impact (2×2 grid)
- Quick wins section (implementable today)

**Content Architecture deliverables:**
- Topic cluster map with hub pages and spoke content
- Keyword-to-URL mapping table
- Content brief templates for priority content

From Im5tu/claude, MIT.

More from Im5tu/claude