Skip to main content
skill CX Codex

seo-optimizer · oakoss — Claude Code skill: what it does, how to install

seo-optimizer — an SEO architecture skill: JSON-LD entities, E-E-A-T signals, topic clusters and a 30-point content audit. Runs in Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode.

MIT 125 installs ★ 29 updated 2026-08-17

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add oakoss/agent-skills --skill seo-optimizer -a claude-code
Open on GitHub

What seo-optimizer does

A skill file that pushes the agent toward entity-based SEO rather than keyword density. It covers JSON-LD for Organization, Article, FAQ and Breadcrumb, E-E-A-T authority signals, AI Overviews, and topic clusters built from a pillar page plus supporting articles.

SKILL.md holds quick-reference tables and a list of common mistakes. Five reference files go deeper: ai-overviews.md, eeat-standards.md, semantic-entity-seo.md, schema-markup.md, content-audit.md. There are also notes on handing work to the Explore, Task and Plan agents: crawling for schema gaps, editing templates, mapping intent and internal links.

Audits use a 30-point score. Definitions aimed at featured snippets sit at 40-60 words, and the skill suggests refreshing key articles every 6 months. Paid ads, social media, email marketing and brand identity sit outside its scope, so reach for it on organic search work only.

What it helps with

  • add Organization and Article JSON-LD to page templates
  • plan a pillar page with supporting cluster articles
  • score a site with a 30-point content audit
  • fix LCP, CLS and INP on key pages
  • fit a definition into 40-60 words for a snippet

Example prompts for the agent

  • Audit the pricing page against the content checklist and list the gaps.
  • Add Article and Breadcrumb JSON-LD to the article template.
  • Map a topic cluster around schema markup and show the internal links.

How to install seo-optimizer

1Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill seo-optimizer -a claude-code

2Manually: put the files in place

~/.claude/skills/seo-optimizer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/seo-optimizer/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about seo-optimizer

How do I install seo-optimizer in Claude Code?

Run npx skills add oakoss/agent-skills --skill seo-optimizer -a claude-code. The skill ends up at ~/.claude/skills/seo-optimizer/SKILL.md.

What does seo-optimizer do?

It guides the agent through SEO architecture: structured data, E-E-A-T signals, topic clusters, content audits, and pages shaped for AI Overviews and featured snippets.

Does seo-optimizer cover paid ads or social media?

No. Paid campaigns, social strategy, email marketing and brand identity design are outside what it handles.

Source text

SKILL.md · MIT
---
name: seo-optimizer
description: 'SEO architecture and content strategy for search visibility. Covers entity-first optimization, structured data, E-E-A-T signals, AI Overviews optimization, and content auditing. Use when optimizing search rankings, implementing JSON-LD schema, improving E-E-A-T signals, auditing site performance, planning topical authority, or structuring content for AI Overviews and featured snippets.'
license: MIT
metadata:
  author: oakoss
  version: '1.1'
---

# 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

- [AI Overviews optimization and search visibility](references/ai-overviews.md)
- [E-E-A-T standards and authority building](references/eeat-standards.md)
- [Semantic entity SEO and topic clusters](references/semantic-entity-seo.md)
- [Schema markup patterns with JSON-LD](references/schema-markup.md)
- [Content audit methodology and scoring](references/content-audit.md)

© oakoss · MIT · oakoss/agent-skills

Similar skills

All skills for SEO and GEO →

seo-optimizer by other authors comes first.

seo-optimizer claude-office-skills seo-optimizer guides keyword research, technical SEO checks and content planning when you need a structured review of a site or page. CX Codex +1 5,000installs seo-optimizer ailabs-393 The seo-optimizer skill scans HTML/CSS pages for SEO faults, then fixes meta tags, structured data and the sitemap. Handy when a site exists but search engines barely notice it. CX Codex +1 1,300installs seo-optimizer davila7 seo-optimizer guides search optimization by generating structured data, meta tags, and content outlines directly in Claude Code. CX Codex +1 11,415installs seo-optimizer secondsky seo-optimizer scores an article on keywords, readability and technical tags, then hands back a prioritized list of fixes. CX Codex +1 462installs seo-optimizer aiskillstore seo-optimizer audits Yoast and Rank Math fields across a WordPress site, then fixes focus keywords, meta descriptions and missing featured images. CX Codex +1 2installs seo-content-auditor sickn33 seo-content-auditor reads the draft you hand it, scores depth, E-E-A-T, readability and keyword use, then lists fixes. Useful before a post goes live. CX Codex +1 ★ 50,109repo stars seo-authority-builder Seth Hobson seo-authority-builder is a Claude Code subagent that checks content for E-E-A-T signals and recommends ways to strengthen credibility. It activates proactively for YMYL topics. CX Codex ★ 42,780repo stars content-quality-auditor aaron-he-zhu content-quality-auditor audits content quality, E-E-A-T, and publish readiness with a typed CORE-EEAT profile. It accepts a URL or pasted material. CX Codex +1 1,700installs eeat-audit inhouseseo eeat-audit audits web pages against Google's E-E-A-T criteria, scores four quality signals, and lists actionable fixes. CX Codex +1 ★ 416repo stars seo-fundamentals davila7 The seo-fundamentals skill gives Claude Code guidance on technical SEO, E-E-A-T, content, and Core Web Vitals. Use it when reviewing pages or site structure. CX Codex +1 920installs seo-content-planner sickn33 seo-content-planner turns one topic into a sectioned article outline, a topic cluster map and a publishing calendar with keyword targets. CX Codex +1 1installs

From the same set106

The whole set →
github-cli github-cli equips AI coding assistants with gh CLI workflows for pull requests, issues, Actions runs, releases, and API calls. CX Codex +1 128installs resend Guides AI agents in integrating the Resend email API, handling React Email templates, domain verification, and Svix webhooks. CX Codex +1 127installs tanstack-pacer Hands your agent a map of TanStack Pacer: debouncing, throttling, rate limits and async queues, with the matching React hooks. Useful when a handler fires too often. CX Codex +1 126installs tanstack-devtools tanstack-devtools guides AI coding agents in configuring Query cache, Router, and Form debugging panels across React applications. CX Codex +1 125installs performance-optimizer performance-optimizer provides structured workflows for profiling, caching, and full-stack performance tuning. Helps eliminate slow database queries, optimize bundles, and reduce API latency. CX Codex +1 124installs storybook-stories Writes Storybook stories and interaction tests in CSF3 format. Handles component examples, Chromatic visual snapshot setup, and accessibility checks. CX Codex +1 124installs shell-integration The shell-integration Claude Code skill provides terminal integration guides and Bash, Zsh, and Fish patterns for completions, prompt hooks, and portable POSIX wrappers. CX Codex +1 123installs usability-tester usability-tester plans usability test sessions, evaluates interfaces against heuristic standards, and scores UX friction points using severity formulas. CX Codex +1 122installs

Project sponsors

Companies that keep this analytics open