Comprehensive SEO optimization Agent Skills for Claude Code & Codex. Based on Google's official documentation, providing integrated support for technical SEO, content SEO, structured data, Core Web Vitals, E-E-A-T, and site audits.
- Technical SEO Checklist - robots.txt, sitemap, canonical, hreflang, etc.
- Content SEO Optimization - Meta tags, heading structure, E-E-A-T strategies
- Structured Data Templates - Article, FAQ, Product, LocalBusiness, etc.
- Core Web Vitals Support - Detailed optimization techniques for LCP, INP, CLS
- Site Audit Workflow - Systematic audit process and report formats
- Practical Code Examples - Ready-to-use templates
Each skill is made up of SKILL.md plus several reference files (technical-seo.md, content-seo.md, etc.). Install all files in a skill folder — fetching only SKILL.md leaves the skill incomplete.
claude plugin marketplace add kpab/seo-mastery-agent-skills
claude plugin install seo-mastery@seo-mastery-agent-skillsThis installs both the English and Japanese skills and keeps them updatable via the plugin manager.
git clone https://github.com/kpab/seo-mastery-agent-skills.git
# Then copy the skill folder(s) you want:
cp -r seo-mastery-agent-skills/.claude/skills/seo-mastery .claude/skills/ # English
cp -r seo-mastery-agent-skills/.claude/skills/seo-mastery-jp .claude/skills/ # JapaneseSKILL=seo-mastery # or seo-mastery-jp
BASE=https://raw.githubusercontent.com/kpab/seo-mastery-agent-skills/main/.claude/skills/$SKILL
mkdir -p .claude/skills/$SKILL
for f in SKILL.md technical-seo.md content-seo.md structured-data.md core-web-vitals.md audit-workflow.md; do
curl -fsSL -o .claude/skills/$SKILL/$f "$BASE/$f"
done# Same as above, but target a Codex skills directory.
# Project local: .codex/skills/$SKILL | User global: ~/.codex/skills/$SKILL
SKILL=seo-mastery # or seo-mastery-jp
BASE=https://raw.githubusercontent.com/kpab/seo-mastery-agent-skills/main/.claude/skills/$SKILL
mkdir -p .codex/skills/$SKILL
for f in SKILL.md technical-seo.md content-seo.md structured-data.md core-web-vitals.md audit-workflow.md; do
curl -fsSL -o .codex/skills/$SKILL/$f "$BASE/$f"
done.claude/skills/
├── seo-mastery/ # English version
│ ├── SKILL.md # Main skill file
│ ├── technical-seo.md # Technical SEO details
│ ├── content-seo.md # Content SEO details
│ ├── structured-data.md # Structured data details
│ ├── core-web-vitals.md # Core Web Vitals details
│ └── audit-workflow.md # Audit workflow details
└── seo-mastery-jp/ # Japanese version
├── SKILL.md # Main skill file
├── technical-seo.md # Technical SEO details
├── content-seo.md # Content SEO details
├── structured-data.md # Structured data details
├── core-web-vitals.md # Core Web Vitals details
└── audit-workflow.md # Audit workflow details
# Request meta tag optimization
"Optimize the meta tags for this page"
# Generate structured data
"Add Article structured data to this blog post"
# Run site audit
"Perform an SEO audit on this site"
# Improve Core Web Vitals
"How can I improve LCP?"
# Generate FAQ structured data
"Add JSON-LD to this FAQ page"
- Article / NewsArticle / BlogPosting
- FAQ (Frequently Asked Questions)*
- HowTo*
- Product
- LocalBusiness
- BreadcrumbList
- VideoObject
- Organization / WebSite
- Event
* FAQ rich results are limited to well-known government/health sites and HowTo rich results were discontinued by Google in 2023. Templates are kept for semantic markup purposes.
- robots.txt template
- sitemap.xml template
- hreflang implementation patterns
- canonical URL configuration
- LCP optimization code
- INP optimization code
- CLS optimization code
- Measurement & monitoring scripts
- Next.js
- Nuxt.js
- Static HTML
- WordPress (reference)
Pull requests and issue reports are welcome! See CONTRIBUTING.md — in particular, the English and Japanese versions must be kept in sync (English is the source of truth).
MIT License