# Seo

> Comprehensive SEO and AI SEO (GEO) skill for auditing pages, optimizing content, and generating strategies. Use when user asks for SEO audits, keyword optimization, SEO strategy, technical SEO checks, or local SEO optimization.

- **Type:** Skill
- **Install:** `agentstack add skill-wikatar-skills-claude-seo-seo`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [wikatar](https://agentstack.voostack.com/s/wikatar)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [wikatar](https://github.com/wikatar)
- **Source:** https://github.com/wikatar/Skills-Claude-SEO/tree/main/.claude/skills/seo

## Install

```sh
agentstack add skill-wikatar-skills-claude-seo-seo
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# SEO Master Skill

> Version 3.3 | Last Updated: January 2026

A comprehensive SEO and AI SEO (GEO) skill for auditing pages, optimizing content, and generating strategies.

---

## Quick Command Reference

| Command | What It Does |
|---------|--------------|
| `/seo ` | **Master mode** - Full auto-diagnosis and action plan |
| `/seo status` | Check progress against strategy |
| `/seo audit ` | Full SEO audit of a page |
| `/seo optimize` | Optimize content for a keyword |
| `/seo strategy` | Generate comprehensive SEO strategy |
| `/seo prioritize` | Decide what to work on first |
| `/seo technical` | Technical SEO checklist |
| `/seo local` | Local SEO optimization |

---

## Persistence & Memory

**SEO is a long-term game.** This skill maintains a `.seo/` folder to track strategy, progress, and learnings across sessions.

### Folder Structure

```
.seo/
├── strategy.md         # Master strategy document
├── inventory.md        # Content pages + their SEO status
├── tasks.md            # Tasks: pending, in-progress, completed
├── keywords.md         # Target keywords + current rankings
└── log.md              # Session log with dated entries
```

### How It Works

**First Session:**
1. Skill checks: Does `.seo/` folder exist?
2. If NO → Create folder + run full analysis → Save to `strategy.md`
3. If YES → Read existing strategy → Continue from where we left off

**Subsequent Sessions:**
1. Read `.seo/strategy.md` to understand current state
2. Check `tasks.md` for pending items
3. Update based on new information
4. Log session notes to `log.md`

### File Templates

**strategy.md:**
```markdown
# SEO Strategy: [Site Name]

> Last updated: [Date]
> Current score: [X/100]

## Overview
- Site: [URL]
- Primary goal: [Goal]
- Target audience: [Audience]

## Current State
[Summary of where we are]

## 90-Day Roadmap
[High-level plan]

## Key Metrics
| Metric | Baseline | Current | Target |
|--------|----------|---------|--------|
| Organic traffic | X | Y | Z |

## Competitors
- [Competitor 1]
- [Competitor 2]
```

**tasks.md:**
```markdown
# SEO Tasks: [Site Name]

## In Progress
- [ ] [Task] - Started [Date]

## Pending
- [ ] [Task] - Priority: High/Medium/Low

## Completed
- [x] [Task] - Completed [Date]
```

**log.md:**
```markdown
# SEO Session Log: [Site Name]

## [Date]
### What we did
- [Action taken]

### Findings
- [Discovery]

### Next session
- [What to focus on]
```

### Key Behaviors

1. **Always check for `.seo/` first** - Before any analysis, look for existing strategy
2. **Update, don't overwrite** - Build on previous work, don't start fresh
3. **Log every session** - Add dated entry to `log.md`
4. **Mark tasks complete** - Move finished items to Completed section
5. **Track metrics** - Note any ranking/traffic changes mentioned

---

## Description

This skill helps you:
- **Audit** websites and pages for traditional SEO and AI SEO issues
- **Optimize** content for both Google and AI search engines (ChatGPT, Perplexity, Gemini)
- **Generate** comprehensive SEO strategies tailored to your goals
- **Prioritize** what to work on for maximum impact

## When to Use This Skill

✅ **Use when:**
- Analyzing a page or site for SEO issues
- Optimizing content for search
- Building an SEO strategy
- Deciding between SEO priorities
- Need technical SEO guidance

❌ **Don't use when:**
- Pure web design/UX (no SEO angle)
- Paid advertising (PPC/SEM)
- Social media strategy (unless SEO-related)

---

## Modes

### Master Mode: Full Analysis (`/seo ` or "Help me with SEO for [site]")

**The autonomous mode.** Give it a URL and it figures out everything.

This mode automatically:
1. **Checks for existing strategy** in `.seo/` folder
2. Diagnoses current state across all SEO dimensions
3. Identifies the biggest problems and opportunities
4. Creates a prioritized action plan
5. **Saves/updates** the strategy files

**When to use:** When you want a complete picture without guiding the analysis yourself.

**Process:**

```
Step 0: CHECK MEMORY
├── Look for .seo/ folder
├── If exists: Read strategy.md, tasks.md, log.md
├── Understand where we left off
└── Continue from there (don't restart)

Step 1: DIAGNOSE
├── Fetch and analyze the page/site
├── Check traditional SEO elements
├── Check AI SEO readiness
├── Check technical fundamentals
├── Identify if local SEO applies
└── Assess E-E-A-T signals

Step 2: IDENTIFY
├── Score current state (0-100)
├── Find critical issues (blocking growth)
├── Find quick wins (high impact, low effort)
├── Find strategic gaps (missing opportunities)
└── Compare to what's needed to compete

Step 3: PLAN
├── Prioritize by impact × effort
├── Create immediate actions (this week)
├── Create 30-day roadmap
├── Create 90-day roadmap
└── Define success metrics

Step 4: PERSIST
├── Create .seo/ folder if needed
├── Write/update strategy.md
├── Update tasks.md with new tasks
├── Add session entry to log.md
└── Confirm files saved
```

**Output Format:**

```
## SEO Master Analysis: [Site/Page]

### Current State Score: [X/100]

| Dimension | Score | Status |
|-----------|-------|--------|
| On-Page SEO | X/20 | 🔴/🟡/🟢 |
| Technical SEO | X/20 | 🔴/🟡/🟢 |
| Content Quality | X/20 | 🔴/🟡/🟢 |
| AI SEO Readiness | X/20 | 🔴/🟡/🟢 |
| Authority/E-E-A-T | X/20 | 🔴/🟡/🟢 |

### Diagnosis Summary
[2-3 sentence overview of the site's SEO health and main issues]

### Critical Issues (Fix First)
1. [Issue] → [Why it matters] → [How to fix]
2. [Issue] → [Why it matters] → [How to fix]

### Quick Wins (High Impact, Easy)
1. [Action] → [Expected impact]
2. [Action] → [Expected impact]

### Strategic Gaps (Bigger Opportunities)
1. [Gap] → [Opportunity size] → [Approach]

### Action Plan

**This Week:**
- [ ] [Specific task 1]
- [ ] [Specific task 2]
- [ ] [Specific task 3]

**Next 30 Days:**
- [ ] [Task with brief description]
- [ ] [Task with brief description]
- [ ] [Task with brief description]

**Next 90 Days:**
- [ ] [Strategic initiative]
- [ ] [Strategic initiative]

### Success Metrics
| Metric | Current | Target (90 days) |
|--------|---------|------------------|
| [Metric] | [Value] | [Goal] |

### What I Need From You
[Questions to clarify or information needed to refine the plan]
```

**Key Behaviors:**

1. **Check memory first** - Always look for `.seo/` folder before starting analysis
2. **Be autonomous** - Don't ask what to analyze. Analyze everything relevant.
3. **Be specific** - Don't say "improve your titles." Say "Change title from X to Y."
4. **Be prioritized** - Always rank by impact. Don't overwhelm with 50 equal tasks.
5. **Be realistic** - Consider effort required. Quick wins first.
6. **Persist everything** - Save strategy, tasks, and session log
7. **Ask at the end** - Only ask questions after providing the analysis, not before.

---

### Status Mode: Check Progress (`/seo status` or "How's my SEO going?")

**Quick check on progress against the existing strategy.**

This mode:
1. Reads `.seo/` folder
2. Summarizes current state vs. goals
3. Shows completed vs. pending tasks
4. Identifies what to focus on next

**Output Format:**
```
## SEO Status: [Site Name]

### Progress Overview
- Strategy started: [Date]
- Current score: [X/100] (was [Y] at baseline)
- Tasks completed: [X/Y]

### Recent Wins
- [x] [Completed task] - [Date]
- [x] [Completed task] - [Date]

### Current Focus
- [ ] [In-progress task]

### Up Next
- [ ] [Next priority task]
- [ ] [Next priority task]

### Blockers / Notes
[Any issues or things to discuss]

### Metrics Trend
| Metric | Baseline | Last Check | Now | Target |
|--------|----------|------------|-----|--------|
| [Metric] | X | Y | Z | Goal |
```

**If no `.seo/` folder exists:** Prompt user to run Master Mode first.

---

### Mode 1: Page Audit (`/seo audit `)

When auditing a page, analyze:

**Traditional SEO:**
- Title tag (length, keyword placement, clarity)
- Meta description (length, CTA, keyword inclusion)
- Header structure (H1-H6 hierarchy)
- Content quality and search intent match
- Internal linking
- External links (quality, relevance)
- Schema markup presence
- Image optimization (alt tags, compression)
- URL structure
- Mobile friendliness indicators
- Page speed indicators (if accessible)

**AI SEO (GEO):**
- Content structure for AI readability (Q&A, lists, steps)
- FAQ presence and quality
- Fact density (statistics, data, citations)
- Quote-worthy statements
- Schema markup for AI (FAQPage, HowTo, Article)
- Content freshness
- Author credentials visibility
- TL;DR presence

**Scoring Rubric (100 points):**

| Category | Points | Criteria |
|----------|--------|----------|
| **Title Tag** | 10 | Length ≤60, keyword front-loaded, compelling |
| **Meta Description** | 5 | Length 150-160, includes keyword, has CTA |
| **H1 Tag** | 10 | Present, unique, contains primary keyword |
| **Header Structure** | 5 | Logical H2-H6 hierarchy |
| **Content Quality** | 15 | Depth, intent match, originality |
| **Internal Links** | 5 | 3-10 relevant contextual links |
| **Schema Markup** | 10 | Appropriate types implemented correctly |
| **Images** | 5 | Alt tags, compression, descriptive names |
| **Technical** | 10 | HTTPS, mobile-friendly, fast loading |
| **AI Readability** | 15 | Structure, FAQs, facts, quotable statements |
| **E-E-A-T Signals** | 10 | Author info, credentials, citations |

**Score Interpretation:**
- 90-100: Excellent - minor tweaks only
- 70-89: Good - some optimization needed
- 50-69: Fair - significant improvements needed
- Below 50: Poor - major overhaul required

**Output Format:**
```
## SEO Audit: [Page Title]

### Score: [X/100]

### Critical Issues 🔴
- [Issue with fix recommendation]

### Warnings 🟡
- [Issue with fix recommendation]

### Opportunities 🟢
- [Improvement suggestion]

### AI SEO Readiness: [X/10]
- [Assessment of GEO optimization]

### Quick Wins
1. [Immediate action]
2. [Immediate action]
3. [Immediate action]
```

---

### Mode 2: Content Optimization (`/seo optimize`)

When optimizing content, consider the user's:
- Target keyword(s)
- Search intent (see Search Intent section)
- Current content
- Target audience
- Competitors ranking for this term

**Provide:**

1. **Title Tag Optimization**
   - Current analysis
   - 2-3 optimized versions
   - Reasoning

2. **Meta Description**
   - Current analysis
   - 2-3 optimized versions

3. **Header Structure**
   - Recommended H1
   - Suggested H2/H3 outline
   - Keyword placement opportunities

4. **Content Enhancements**
   - Missing topics to cover (content gaps)
   - FAQ suggestions (4-8 questions)
   - Statistics/data to add
   - Internal linking opportunities
   - External citation opportunities

5. **AI Optimization**
   - TL;DR summary to add
   - Quote-worthy statements to include
   - Schema markup recommendations (with example code)

6. **Image Optimization**
   - Suggested images to add
   - Alt text recommendations

---

### Mode 3: Strategy Generation (`/seo strategy`)

When generating strategy, gather information about:
- Business type and goals
- Current website state
- Target audience
- Competitors (ask for 2-3)
- Resources available
- Timeline

**Provide:**

1. **Situation Analysis**
   - Current state assessment
   - Competitor analysis (what they do well/poorly)
   - SWOT for SEO
   - Opportunities

2. **Keyword Strategy**
   - Target keyword clusters (grouped by intent)
   - Priority topics
   - Content gap analysis
   - Quick win keywords (low competition)

3. **Content Strategy**
   - Pillar pages to create
   - Content cluster plan
   - Publishing cadence recommendation
   - Refresh schedule for existing content

4. **Technical Priorities**
   - Critical fixes
   - Quick wins
   - Long-term improvements

5. **AI SEO (GEO) Strategy**
   - Schema implementation plan
   - Content structure changes
   - AI crawler policy (robots.txt)
   - Visibility monitoring approach

6. **Link Building Approach**
   - Linkable asset ideas
   - Digital PR opportunities
   - Outreach priorities
   - Timeline expectations (3-6 months)

7. **Local SEO** (if applicable)
   - Google Business Profile optimization
   - Local citations
   - Review strategy

8. **Measurement Plan**
   - KPIs to track
   - Tools to use
   - Reporting cadence

---

### Mode 4: Prioritization (`/seo prioritize`)

Help users decide what to work on first. This is critical for ROI.

**The Core Question:** Should I fix weak pages or double down on strong pages?

**Decision Framework:**

#### Double Down on Best Pages FIRST when:
- Pages ranking positions 4-20 (striking distance)
- High impressions but low CTR
- Best content is outdated (>6 months old)
- Limited resources (focus beats spread)

**Why:** Moving from position 8→3 = massive traffic jump. Content refresh can boost traffic 106%. AI search heavily favors recently updated authoritative content.

**Impact:** HIGH and FAST (weeks)

#### Fix/Remove Worst Pages FIRST when:
- Thin content (2 hops |
| Duplicate content | Canonicals handle duplicates |
| Hreflang | Correct (if multi-language) |
| Structured data | Valid, no errors in GSC |
| Page speed | ` tags
   - Clear column headers
   - 3-4 columns, 4-8 rows typical

5. **Snippet-friendly formatting:**
   - Question as H2, answer immediately after
   - First sentence answers the query completely
   - Expand with details below

**Example Structure:**
```html
How long does SEO take to work?
SEO typically takes 3-6 months to show significant results, though
competitive keywords may take 6-12 months. Early wins like technical
fixes can improve rankings within weeks, while building authority
through content and links requires sustained effort.
```

### CTR Optimization (Click-Through Rate)

**Why it matters:** Higher CTR = more traffic from same rankings. Can indirectly improve rankings through engagement signals.

**Power Words That Increase CTR:**

| Category | Words |
|----------|-------|
| **Urgency** | Now, Today, Fast, Quick, Instant |
| **Value** | Free, Bonus, Exclusive, Premium |
| **Trust** | Proven, Guaranteed, Official, Certified |
| **Curiosity** | Secret, Hidden, Surprising, Strange |
| **Emotion** | Amazing, Incredible, Essential, Powerful |

**Title Tag CTR Boosters:**

1. **Numbers increase CTR 36%**
   - "7 Ways to..." beats "Ways to..."
   - Odd numbers outperform even
   - Specific > round (37 beats 40)

2. **Brackets increase CTR 38%**
   - [2026 Guide]
   - (With Examples)
   - [Free Template]

3. **Year signals freshness**
   - "Best CRM Software 2026"
   - Critical for fast-moving topics

4. **Question format for informational**
   - "What is X?" matches voice search
   - Triggers curiosity

**CTR-Optimized Title Formulas:**

```
[Number] [Adjective] [Keyword] [Promise] [Year/Bracket]

Examples:
- 17 Proven SEO Tactics That Actually Work [2026]
- How to [Achieve X] in [Timeframe] (Step-by-Step)
- [Keyword]: The Ultimate Guide [Free Template]
- [X] vs [Y]: Which is Better? (Honest Comparison)
```

**Meta Description CTR Tactics:**
- Start with action verb or hook
- Include a number or statistic
- Add social proof if possible
- End with CTA (Learn more, Get started, See how)
- Use special characters sparingly (→ ✓ |)

### Link Building Playbook

**The Hierarchy of Link Value:**

| Link Type | Value | Difficulty |
|-----------|-------|------------|
| Editorial from major publications | Highest | Very Hard |
| Industry authority sites | Very High | Hard |
| Relevant niche blogs | High | Medium |
| Resource pages | Medium-High | Medium |
| Guest posts (quality sites) | Medium | Medium |
| Directories (quality) | Low-Medium | Easy |
| Social profiles | Low | Easy |

**Proven Link Building Tactics:**

#### 1. Broken Link Building
- Find broken links on relevant sites (use Ahrefs, Check My Links extension)
- Create content that replaces the dead resource
- Email webmaster offering your replacement
- **Success rate:** 5-15%

#### 2. Skyscraper Technique
1. Find content with lots of backlinks in your niche
2. Create something significantly better (lo

…

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [wikatar](https://github.com/wikatar)
- **Source:** [wikatar/Skills-Claude-SEO](https://github.com/wikatar/Skills-Claude-SEO)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-wikatar-skills-claude-seo-seo
- Seller: https://agentstack.voostack.com/s/wikatar
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.