Skip to content
cccskills
FreePublished on GitHub

seo-optimizer

SEO optimization with keyword analysis, readability assessment, technical validation, content quality. Use for search rankings, blog posts, content audits, or encountering keyword density, readability scores, meta tags, schema markup errors.

The English summary is being prepared. Showing the original description.

See how to install

Files included (3)

  • SKILL.md6.3 KB
  • references/analysis-framework.md11.2 KB
  • references/output-templates.md17.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

SEO Optimizer

Overview

Perform comprehensive SEO analysis and optimization covering keyword placement, readability metrics, technical elements, and content quality to improve search engine rankings and user experience.

When to Use

  • Optimizing blog posts or articles for search rankings
  • Conducting content audits
  • Improving existing content performance
  • Planning new content with SEO in mind
  • Analyzing competitor content strategies
  • Preparing content for publication

Core Analysis Areas

1. Target Keywords Analysis

  • Identify primary and secondary keywords
  • Check placement in title, H1, first 100 words, subheadings
  • Calculate keyword density (target: 1-2%)
  • Identify LSI keywords and semantic variations
  • Flag keyword stuffing issues

2. Content Structure

  • Verify heading hierarchy (H1 → H2 → H3)
  • Check keyword usage in headings
  • Evaluate paragraph length (target: <150 words)
  • Assess overall scannability
  • Review content organization

3. Readability Metrics

// Readability scoring example
const readabilityMetrics = {
  fleschScore: 65,           // Target: 60-70
  gradeLevel: 8,             // Target: 7-9
  avgSentenceLength: 18,     // Target: <20 words
  passiveVoice: 5,           // Target: <10%
  transitionWords: 30        // Target: >30%
};

Key Metrics:

  • Flesch Reading Ease score (60-70 ideal)
  • Grade level estimation
  • Average sentence length (<20 words)
  • Passive voice percentage (minimize)
  • Transition word usage

4. Technical SEO Elements

ElementRecommendation
Meta Title50-60 characters with primary keyword
Meta Description150-160 characters, compelling with keyword
URL SlugShort, keyword-rich, hyphen-separated
Image Alt TextDescriptive with natural keyword usage
Internal LinksLink to related content with keyword anchors
External LinksQuality outbound links to authoritative sources

5. Content Quality Assessment

  • Word count adequacy (1500+ for competitive topics)
  • Content depth and topic coverage
  • Unique value proposition
  • E-A-T signals (Expertise, Authority, Trustworthiness)
  • Content freshness (current examples, recent data)
  • Clear answer to user intent

6. Provide Actionable Recommendations

Organize findings into prioritized action items based on impact and implementation effort.

Priority Levels

Critical (Fix Immediately) 🚨

  • Missing or poor meta description
  • No keyword in title or H1
  • Broken internal links
  • Keyword density too high (stuffing) or too low

High Priority ⚠️

  • Poor readability score
  • Weak heading structure
  • Missing alt text on images
  • Content too thin for topic

Medium Priority 📋

  • Could add related keywords
  • Featured snippet opportunities
  • Additional internal linking
  • Schema markup opportunities

Analysis Report Structure

# SEO Analysis Report

## Overall Score: X/100

### Quick Wins 🚀
1. [Specific action with exact change]
2. [Specific action with exact change]

## Keyword Analysis
- Primary keyword density
- Placement verification
- LSI keyword coverage

## Readability Metrics
- Flesch Reading Ease: XX/100
- Grade Level: X
- Sentence length assessment

## Technical SEO
- Meta tags analysis
- URL optimization
- Image optimization

## Content Gaps
- Missing subtopics
- Coverage recommendations
- Topic expansion opportunities

## Competitor Insights
- Top ranking pages analysis
- Word count comparison
- Unique angles they cover
- Our competitive advantage

## Implementation Checklist
- [ ] Action item 1
- [ ] Action item 2

## Estimated Impact
- **Time to Implement**: X hours
- **Expected Improvement**: [Moderate/Significant] ranking boost
- **Priority**: [High/Medium/Low]
- **Timeframe**: [Weeks until results]

Best Practices

  • User experience first: Prioritize readability and value over keyword density
  • Write for humans: Optimize for search engines second
  • Be specific: Provide exact changes, not vague suggestions
  • Consider intent: Match content to search intent (informational, commercial, transactional)
  • E-A-T signals: Include author credentials, sources, and expertise indicators
  • Featured snippets: Format content for definition boxes, lists, tables
  • Schema markup: Suggest structured data (FAQ, How-To, Review) where relevant

Example Analysis Flow

  1. Identify keywords → Extract from user input or content
  2. Check placement → Verify in title, H1, first 100 words
  3. Calculate density → Ensure 1-2% keyword density
  4. Assess readability → Calculate Flesch score and sentence length
  5. Review structure → Check heading hierarchy and paragraph length
  6. Analyze technical → Validate meta tags, URLs, alt text
  7. Find gaps → Identify missing topics and internal links
  8. Prioritize fixes → Sort by impact (critical > high > medium)
  9. Generate checklist → Create actionable implementation steps

Output Guidelines

  • Provide specific recommendations with exact text changes
  • Show before/after examples for clarity
  • Include keyword variations naturally in suggestions
  • Estimate time to implement and expected impact
  • Format for easy scanning with headings and lists
  • Add context explaining why changes matter

Additional Resources

See references/analysis-framework.md for:

  • Detailed analysis instructions for each area
  • Technical specifications and formulas
  • Competitor analysis guidelines
  • E-A-T evaluation criteria

See references/output-templates.md for:

  • Complete SEO report template
  • Implementation checklist format
  • Example workflow with sample content
  • Featured snippet optimization templates

Core Philosophy

"SEO is about creating valuable, well-optimized content that serves user intent better than competitors."

Focus on genuine value creation, not manipulation tactics. Quality content that helps users naturally attracts engagement signals that improve rankings.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

100+ animated React components (Aceternity UI) for Next.js with Tailwind. Use for hero sections, parallax, 3D effects, or encountering animation, shadcn CLI integration errors.

The English summary is being prepared. Showing the original description.

secondsky/claude-skills231Updated Sep 28, 2026

Secure API authentication with JWT, OAuth 2.0, API keys. Use for authentication systems, third-party integrations, service-to-service communication, or encountering token management, security headers, auth flow errors.

The English summary is being prepared. Showing the original description.

secondsky/claude-skills231Updated Sep 28, 2026

Creates comprehensive API changelogs documenting breaking changes, deprecations, and migration strategies for API consumers. Use when managing API versions, communicating breaking changes, or creating upgrade guides.

The English summary is being prepared. Showing the original description.

secondsky/claude-skills231Updated Sep 28, 2026

Verifies API contracts between services using consumer-driven contracts, schema validation, and tools like Pact. Use when testing microservices communication, preventing breaking changes, or validating OpenAPI specifications.

The English summary is being prepared. Showing the original description.

secondsky/claude-skills231Updated Sep 28, 2026

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing API design standards.

The English summary is being prepared. Showing the original description.

secondsky/claude-skills231Updated Sep 28, 2026

Implements standardized API error responses with proper status codes, logging, and user-friendly messages. Use when building production APIs, implementing error recovery patterns, or integrating error monitoring services.

The English summary is being prepared. Showing the original description.

secondsky/claude-skills231Updated Sep 28, 2026

See all skills by secondsky

Report a problem with this skill