mcpField
S
seo-optimizer

seo-optimizer

github.com/oakossMarketing & growth20118 installsUpdated 11w ago
Repository

About seo-optimizer

A guidance skill for SEO practitioners covering semantic content strategy, structured data, audits, and search visibility.

Key features

  1. 01AI Overviews content patterns
  2. 02E-E-A-T authority signals
  3. 03JSON-LD structured data
  4. 04Topic cluster planning
  5. 05Content audits and Core Web Vitals

Use cases

  1. 01Plan pillar pages and topic clusters
  2. 02Audit schema and page structure
  3. 03Target featured snippets
  4. 04Improve Core Web Vitals

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/oakoss/agent-skills --skill seo-optimizer

After installing, type/seo-optimizerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
ai-overviews.md
content-audit.md
eeat-standards.md
schema-markup.md
semantic-entity-seo.md

Details

From the project README

SEO Optimizer

Overview

Optimizes digital visibility through entity-based SEO, structured data, and content architecture. Focuses on AI Overviews optimization, E-E-A-T authority signals, and semantic topic clustering rather than keyword-centric approaches.

When to use: Search ranking optimization, structured data implementation, content audits, topical authority planning, featured snippet targeting, Core Web Vitals improvement.

When NOT to use: Paid advertising campaigns, social media strategy, email marketing, brand identity design.

Quick Reference

PatternApproachKey Points
AI OverviewsQuestion-based H2s with direct answers1-2 sentence answer before expanding; scannable lists
E-E-A-T signalsExperience-led content with author biosFirst-hand evidence, SME review labels, credentials
Structured dataJSON-LD schema for entitiesOrganization, Article, FAQ, Breadcrumb schemas
Topic clustersPillar page + cluster architectureInternal links flow between pillar and clusters
Semantic SEOIntent mapping + related termsMap pages to Informational/Commercial/Transactional intent
Content audit30-point scoring methodologyTitle, meta, keywords, structure, snippets, linking, technical
Featured snippetsFormat-matched content blocks40-60 word definitions, numbered steps, comparison tables
Schema markupExplicit entity definitionsDefine Who/What/Where in first paragraph + Schema.org
Content freshnessPeriodic refresh protocolUpdate critical articles every 6 months with current data
Core Web VitalsPerformance-first designLCP, CLS, INP monitoring and continuous improvement

Common Mistakes

MistakeCorrect Pattern
Keyword stuffing to boost rankingsUse semantic SEO with semantically related terms and natural language
Publishing generic AI-generated content without expert reviewLead with first-hand experience and E-E-A-T signals
Ignoring Core Web Vitals (LCP, CLS, INP) impact on rankingsImplement performance-first design and monitor vitals continuously
Using hidden or incomplete JSON-LD schema markupDefine explicit, complete structured data that maps entities clearly
Building thin affiliate pages without topical depthCreate pillar pages with full cluster coverage
Writing definitions longer than 60 words for snippet targetingKeep definition paragraphs to 40-60 words for featured snippet eligibility
Using non-descriptive anchor text like "click here" or "read more"Use keyword-rich descriptive anchor text that describes the destination
Missing primary keyword from title, description, or first 100 wordsPlace primary keyword in title, meta description, first paragraph, and one H2

Delegation

  • Audit a site for technical SEO issues, missing schema, and Core Web Vitals problems: Use Explore agent to crawl pages and identify structured data gaps
  • Implement JSON-LD schema markup and meta tags across page templates: Use Task agent to add Organization, Article, FAQ, and Breadcrumb schemas
  • Plan a topical authority strategy with pillar pages and content clusters: Use Plan agent to map keyword intent, cluster hierarchy, and internal linking architecture

References

Comments

Markdown supported