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
npx skills add oakoss/agent-skills --skill seo-optimizer -a claude-codeWhat 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
pricingpage against the content checklist and list the gaps. - Add Article and Breadcrumb JSON-LD to the article template.
- Map a topic cluster around
schema markupand show the internal links.
How to install seo-optimizer
1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill seo-optimizer -a claude-code2Manually: put the files in place
~/.claude/skills/seo-optimizer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/seo-optimizer/
1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill seo-optimizer -a codex2Manually: put the files in place
.agents/skills/seo-optimizer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill seo-optimizer -a cursor2Manually: put the files in place
.cursor/skills/seo-optimizer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install oakoss/agent-skills skills/seo-optimizer2Manually: put the files in place
.github/skills/seo-optimizer/SKILL.md1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill seo-optimizer -a gemini-cli2Platform CLI
gemini skills install https://github.com/oakoss/agent-skills --path skills/seo-optimizerManually: put the files in place
.devin/skills/seo-optimizer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill seo-optimizer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.