Seo

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:

# 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:

# SEO Tasks: [Site Name]

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

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

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

log.md:

# 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

1. Meta Description

• Current analysis
• 2-3 optimized versions

1. Header Structure

• Recommended H1
• Suggested H2/H3 outline
• Keyword placement opportunities

1. Content Enhancements

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

1. AI Optimization

• TL;DR summary to add
• Quote-worthy statements to include
• Schema markup recommendations (with example code)

1. 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

1. Keyword Strategy

• Target keyword clusters (grouped by intent)
• Priority topics
• Content gap analysis
• Quick win keywords (low competition)

1. Content Strategy

• Pillar pages to create
• Content cluster plan
• Publishing cadence recommendation
• Refresh schedule for existing content

1. Technical Priorities

• Critical fixes
• Quick wins
• Long-term improvements

1. AI SEO (GEO) Strategy

• Schema implementation plan
• Content structure changes
• AI crawler policy (robots.txt)
• Visibility monitoring approach

1. Link Building Approach

• Linkable asset ideas
• Digital PR opportunities
• Outreach priorities
• Timeline expectations (3-6 months)

1. Local SEO (if applicable)

• Google Business Profile optimization
• Local citations
• Review strategy

1. 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

1. Snippet-friendly formatting:

• Question as H2, answer immediately after
• First sentence answers the query completely
• Expand with details below

Example Structure:

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)

1. Brackets increase CTR 38%

• [2026 Guide]
• (With Examples)
• [Free Template]

1. Year signals freshness

• "Best CRM Software 2026"
• Critical for fast-moving topics

1. 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
• Source: wikatar/Skills-Claude-SEO
• License: MIT

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