Ultimate SEO Optimizer

A Claude Code skill for comprehensive search engine optimization across content, technical implementation, and strategic planning. This skill provides actionable guidance for improving organic search visibility, keyword targeting, content optimization, and site performance.

When to Use This Skill

Choose Ultimate SEO Optimizer when:

• You need to optimize existing content for better search rankings
• You want keyword research and targeting recommendations
• You need a content optimization workflow with specific improvements
• You're planning a content strategy based on search data
• You want to improve click-through rates from search results

Consider alternatives when:

• You need a full technical SEO audit (use an advanced SEO platform skill)
• You want programmatic content generation (use a programmatic SEO skill)
• You need schema markup specifically (use a schema markup skill)

Quick Start

Copy
# Install the skill
claude install ultimate-seo-optimizer

# Optimize a specific page
claude "Optimize this blog post to rank for 'how to build a REST API with Node.js': [paste content]"

# Keyword research
claude "Find keyword opportunities for a developer tools blog. We currently rank for 'API testing' and 'REST client'"

# Content strategy
claude "Create a 3-month content calendar targeting keywords in the CI/CD and DevOps space"

Core Concepts

Content Optimization Process

Step	Action	Output
Keyword Analysis	Research target keyword, intent, and difficulty	Primary keyword + LSI terms
SERP Analysis	Study top 5 results for structure and coverage	Content outline with gaps
Content Scoring	Grade current content against top results	Score card with improvements
Optimization	Apply on-page improvements and content enhancements	Optimized content
Monitoring	Track ranking changes over 30-60 days	Performance report

Keyword Research Framework

Seed Keywords → Expand with:
  ├── Google Suggest (autocomplete)
  ├── People Also Ask questions
  ├── Related Searches at bottom of SERP
  ├── Competitor keyword gaps
  └── Long-tail variations

Evaluate each keyword by:
  1. Search Volume (monthly searches)
  2. Keyword Difficulty (competition level)
  3. Search Intent (informational, commercial, transactional)
  4. Business Relevance (how closely it relates to your product)
  5. Current Rankings (are you already ranking? How high?)

Content Optimization Checklist

Element	Best Practice	Common Issue
Title Tag	Primary keyword + compelling hook, < 60 chars	Keyword-stuffed or too generic
H1	Single H1 with primary keyword variation	Missing or duplicate H1s
Content Depth	Cover subtopics that top results include	Superficial coverage vs. competitors
Media	Original images, diagrams, code examples	Stock photos with no value
Internal Links	3-5 links to related content	No internal links or irrelevant links
External Links	Cite authoritative sources	No citations or linking to competitors

Configuration

Parameter	Type	Default	Description
content_type	string	"blog"	Type: blog, landing_page, product_page, documentation
target_keyword	string	""	Primary keyword to optimize for
competitor_urls	string[]	[]	Competitor pages ranking for your target keyword
optimization_level	string	"thorough"	Level: quick_wins, standard, thorough
include_technical	boolean	true	Include technical SEO recommendations

Best Practices

1. Analyze the SERP before writing — Look at what's ranking and understand why. If all top results are 3,000-word guides, a 500-word post won't compete. If they're all listicles, don't write an essay. Match the format that Google already rewards.

2. Optimize for topics, not just keywords — Google understands semantic relationships. Cover the topic comprehensively by including related subtopics, questions, and entities. A page about "REST API design" should also cover authentication, error handling, and versioning.

3. Improve existing content before creating new — Updating a page that ranks on page 2 to reach page 1 is often easier than ranking a brand new page. Identify your "striking distance" keywords (positions 4-20) and optimize those pages first.

4. Title tags are your biggest CTR lever — A more compelling title tag can increase clicks by 20-30% without changing your ranking position. Test different formats: questions, numbers, power words, brackets for format indicators [Guide], [2026].

5. Build topical clusters — Create a pillar page for your main topic and link it to 8-15 cluster pages covering subtopics. This signals topical authority to Google and provides comprehensive coverage for users.

Common Issues

Optimized content but rankings didn't improve — SEO takes time, typically 4-8 weeks for changes to take effect. If after 60 days you see no movement, check that your page is indexed, your site has sufficient authority, and the content truly matches search intent better than competitors.

Ranking for wrong intent — If you're ranking for an informational keyword with a product page, Google may keep you off page 1 because the intent doesn't match. Create content that matches the dominant intent for your target keyword.

Cannibalization between pages — If multiple pages target the same keyword, they compete with each other. Consolidate them into one comprehensive page or differentiate their target keywords so each page has a unique focus.