seo-optimizer
Guidance for optimizing website technical SEO, content strategy, and schema markup.
Install
mkdir -p .claude/skills/seo-optimizer-pikakit && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/14234" && unzip -o skill.zip -d .claude/skills/seo-optimizer-pikakit && rm skill.zipInstalls to .claude/skills/seo-optimizer-pikakit
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
SEO fundamentals: E-E-A-T, Core Web Vitals, and Google algorithm optimization. Use when optimizing pages for search engines, improving meta tags, or auditing SEO. NOT for performance profiling (use perf-optimizer) or marketing copy (use copywriting).Key capabilities
- →Apply E-E-A-T framework principles for content quality
- →Optimize pages for Core Web Vitals targets (LCP, INP, CLS)
- →Implement schema markup based on page type
- →Follow content SEO rules for title tags, meta descriptions, and H1s
- →Perform technical SEO checks like sitemap submission and HTTPS configuration
- →Generate SEO recommendations
How it works
The skill applies a framework of E-E-A-T principles, Core Web Vitals targets, and content/technical SEO rules to generate recommendations for search engine optimization.
Inputs & outputs
When to use seo-optimizer
- →Audit technical SEO
- →Implement schema markup
- →Optimize meta tags for ranking
- →Improve search visibility
About this skill
SEO Optimizer — Search Engine Visibility
E-E-A-T for trust. CWV for speed. Schema for rich snippets. Content rules for ranking.
5 Must-Ask Questions (Before SEO Optimization)
| # | Question | Options |
|---|---|---|
| 1 | Target? | Traditional SEO / GEO (AI citations) / Both |
| 2 | Current State? | Lighthouse score / Search Console data / No baseline |
| 3 | Priority? | Technical SEO fixes / Content optimization / Schema markup |
| 4 | Audience? | B2B / B2C / Developer / General consumer |
| 5 | Platform? | Next.js / Vite / Static HTML / WordPress |
When to Use
| Situation | Approach |
|---|---|
| New website | Technical SEO checklist (7 items) |
| Content pages | E-E-A-T + Content SEO rules |
| Performance issues | Core Web Vitals targets |
| AI search visibility | Use geo-spatial skill instead |
System Boundaries
| Owned by This Skill | NOT Owned |
|---|---|
| E-E-A-T framework (4 principles) | AI search (→ geo-spatial) |
| Content SEO (char limits) | Performance profiling (→ perf-optimizer) |
| Schema routing (5 types) | Web fundamentals (→ web-core) |
| Technical SEO checklist | HTML implementation |
Expert decision skill: Produces SEO recommendations. Does not modify pages.
E-E-A-T Framework (4 Principles — Fixed)
| Principle | Signals |
|---|---|
| Experience | First-hand knowledge, real examples |
| Expertise | Credentials, depth of knowledge |
| Authoritativeness | Backlinks, industry recognition |
| Trustworthiness | HTTPS, transparency, accuracy |
Core Web Vitals (Fixed Targets)
| Metric | Good | Poor | Measures |
|---|---|---|---|
| LCP | < 2.5s | > 4.0s | Loading speed |
| INP | < 200ms | > 500ms | Interactivity |
| CLS | < 0.1 | > 0.25 | Visual stability |
Content SEO (Fixed Rules)
| Element | Constraint |
|---|---|
| Title tag | 50-60 chars, keyword front-loaded |
| Meta description | 150-160 chars, compelling CTA |
| H1 | One per page, contains main keyword |
| Alt text | Descriptive, not keyword-stuffed |
Technical SEO Checklist (7 Items)
- XML sitemap submitted
- robots.txt configured
- Canonical tags on all pages
- HTTPS enabled
- Mobile-friendly (responsive)
- Clean URLs (no query params)
- Schema markup present
Schema Routing (5 Types — Deterministic)
| Page Type | Schema Type |
|---|---|
| Blog posts, news | Article |
| Company info | Organization |
| Q&A content | FAQPage |
| E-commerce | Product |
| Navigation | BreadcrumbList |
Ranking Factors (Prioritized)
| Priority | Factor |
|---|---|
| 1 | Quality, relevant content |
| 2 | Backlinks from authority sites |
| 3 | Page experience (Core Web Vitals) |
| 4 | Mobile-first indexing |
| 5 | Technical SEO fundamentals |
Error Taxonomy
| Code | Recoverable | Trigger |
|---|---|---|
ERR_INVALID_REQUEST_TYPE | No | Request type not supported |
ERR_UNKNOWN_PAGE_TYPE | Yes | Page type not one of 5 |
ERR_INVALID_CWV | Yes | CWV scores not valid numbers |
Zero internal retries. Same page type = same recommendation.
Audit Logging (OpenTelemetry)
| Event | Metadata Payload | Severity |
|---|---|---|
audit_started | {"scope": "full_audit", "url": "..."} | INFO |
cwv_measured | {"lcp_ms": 1800, "inp_ms": 120, "cls": 0.05} | INFO |
schema_added | {"type": "Article", "page": "/blog/post-1"} | INFO |
audit_completed | {"lighthouse_seo": 98, "fixes_applied": 12} | INFO |
All SEO outputs MUST emit audit_started and audit_completed events.
Anti-Patterns
| ❌ Don't | ✅ Do |
|---|---|
| Keyword stuff title/alt text | Use natural language with keyword |
| Skip meta descriptions | Write compelling 150-160 char descriptions |
| Ignore Core Web Vitals | Meet LCP/INP/CLS targets |
| Use generic schema | Route schema by page type |
📑 Content Map
| File | Description | When to Read |
|---|---|---|
| engineering-spec.md | Full spec | Architecture review |
🔗 Related
| Item | Type | Purpose |
|---|---|---|
geo-spatial | Skill | AI search (GEO) |
perf-optimizer | Skill | Core Web Vitals |
⚡ PikaKit v3.9.213
When not to use it
- →For performance profiling
- →For marketing copy creation
- →For AI search visibility (GEO)
Limitations
- →The skill produces SEO recommendations and does not modify pages directly.
- →It does not cover AI search (GEO) or performance profiling.
- →It relies on fixed targets for Core Web Vitals and content SEO rules.
How it compares
This skill provides a structured, rule-based approach to SEO optimization, offering specific recommendations based on established frameworks, unlike a general content creation or performance tuning process.
Compared to similar skills
seo-optimizer side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| seo-optimizer (this skill) | 0 | 2mo | No flags | Intermediate |
| google-official-seo-guide | 143 | 9mo | No flags | Beginner |
| seo-optimizer | 33 | 7mo | No flags | Intermediate |
| seo-content-writer | 24 | 3mo | No flags | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by pikakit
View all by pikakit →You might also like
google-official-seo-guide
littleben
Official Google SEO guide covering search optimization, best practices, Search Console, crawling, indexing, and improving website search visibility based on official Google documentation
seo-optimizer
davila7
Search Engine Optimization specialist for content strategy, technical SEO, keyword research, and ranking improvements. Use when optimizing website content, improving search rankings, conducting keyword analysis, or implementing SEO best practices. Expert in on-page SEO, meta tags, schema markup, and Core Web Vitals.
seo-content-writer
sickn33
Writes SEO-optimized content based on provided keywords and topic briefs. Creates engaging, comprehensive content following best practices. Use PROACTIVELY for content creation tasks.
content-creation
anthropics
Draft marketing content across channels — blog posts, social media, email newsletters, landing pages, press releases, and case studies. Use when writing any marketing content, when you need channel-specific formatting, SEO-optimized copy, headline options, or calls to action.
content-marketer
sickn33
Elite content marketing strategist specializing in AI-powered content creation, omnichannel distribution, SEO optimization, and data-driven performance marketing. Masters modern content tools, social media automation, and conversion optimization with 2024/2025 best practices. Use PROACTIVELY for comprehensive content marketing.
competitor-alternatives
davila7
When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' or 'competitive landing pages.' Covers four formats: singular alternative, plural alternatives, you vs competitor, and competitor vs competitor. Emphasizes deep research, modular content architecture, and varied section types beyond feature tables.