skills/oakoss/agent-skills/seo-optimizer

seo-optimizer

SKILL.md

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

Pattern Approach Key Points
AI Overviews Question-based H2s with direct answers 1-2 sentence answer before expanding; scannable lists
E-E-A-T signals Experience-led content with author bios First-hand evidence, SME review labels, credentials
Structured data JSON-LD schema for entities Organization, Article, FAQ, Breadcrumb schemas
Topic clusters Pillar page + cluster architecture Internal links flow between pillar and clusters
Semantic SEO Intent mapping + related terms Map pages to Informational/Commercial/Transactional intent
Content audit 30-point scoring methodology Title, meta, keywords, structure, snippets, linking, technical
Featured snippets Format-matched content blocks 40-60 word definitions, numbered steps, comparison tables
Schema markup Explicit entity definitions Define Who/What/Where in first paragraph + Schema.org
Content freshness Periodic refresh protocol Update critical articles every 6 months with current data
Core Web Vitals Performance-first design LCP, CLS, INP monitoring and continuous improvement

Common Mistakes

Mistake Correct Pattern
Keyword stuffing to boost rankings Use semantic SEO with semantically related terms and natural language
Publishing generic AI-generated content without expert review Lead with first-hand experience and E-E-A-T signals
Ignoring Core Web Vitals (LCP, CLS, INP) impact on rankings Implement performance-first design and monitor vitals continuously
Using hidden or incomplete JSON-LD schema markup Define explicit, complete structured data that maps entities clearly
Building thin affiliate pages without topical depth Create pillar pages with full cluster coverage
Writing definitions longer than 60 words for snippet targeting Keep 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 words Place 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

Weekly Installs
19
GitHub Stars
4
First Seen
Feb 23, 2026
Installed on
claude-code17
opencode16
github-copilot15
codex15
kimi-cli15
gemini-cli15