explainx.ainewsletter3.4k
Marketing

seo-optimizer▌

ailabs-393/ai-labs-claude-skills · updated Apr 8, 2026

MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.

$npx skills add https://github.com/ailabs-393/ai-labs-claude-skills --skill seo-optimizer
0 commentsdiscussion
summary

This skill provides comprehensive SEO optimization capabilities for HTML/CSS websites. It analyzes websites for SEO issues, implements best practices, and generates optimization reports covering all critical SEO aspects including meta tags, heading structure, image optimization, schema markup, mobile optimization, and technical SEO.

skill.md

SEO Optimizer

Overview

This skill provides comprehensive SEO optimization capabilities for HTML/CSS websites. It analyzes websites for SEO issues, implements best practices, and generates optimization reports covering all critical SEO aspects including meta tags, heading structure, image optimization, schema markup, mobile optimization, and technical SEO.

When to Use This Skill

Use this skill when the user requests:

  • "Analyze my website for SEO issues"
  • "Optimize this page for SEO"
  • "Generate an SEO audit report"
  • "Fix SEO problems on my website"
  • "Add proper meta tags to my pages"
  • "Implement schema markup"
  • "Generate a sitemap"
  • "Improve my site's search engine rankings"
  • Any task related to search engine optimization for HTML/CSS websites

Workflow

1. Initial SEO Analysis

Start with comprehensive analysis using the SEO analyzer script:

python scripts/seo_analyzer.py <directory_or_file>

This script analyzes HTML files and generates a detailed report covering:

  • Title tags (length, presence, uniqueness)
  • Meta descriptions (length, presence)
  • Heading structure (H1-H6 hierarchy)
  • Image alt attributes
  • Open Graph tags
  • Twitter Card tags
  • Schema.org markup
  • HTML lang attribute
  • Viewport and charset meta tags
  • Canonical URLs
  • Content length

Output Options:

  • Default: Human-readable text report with issues, warnings, and good practices
  • --json: Machine-readable JSON format for programmatic processing

Example Usage:

# Analyze single file
python scripts/seo_analyzer.py index.html

# Analyze entire directory
python scripts/seo_analyzer.py ./public

# Get JSON output
python scripts/seo_analyzer.py ./public --json

2. Review Analysis Results

The analyzer categorizes findings into three levels:

Critical Issues (🔴) - Fix immediately:

  • Missing title tags
  • Missing meta descriptions
  • Missing H1 headings
  • Images without alt attributes
  • Missing HTML lang attribute

Warnings (⚠️) - Fix soon for optimal SEO:

  • Suboptimal title/description lengths
  • Multiple H1 tags
  • Missing Open Graph or Twitter Card tags
  • Missing viewport meta tag
  • Missing schema markup
  • Heading hierarchy issues

Good Practices (✅) - Already optimized:

  • Properly formatted elements
  • Correct lengths
  • Present required tags

3. Prioritize and Fix Issues

Address issues in priority order:

Priority 1: Critical Issues

Missing or Poor Title Tags:

<!-- Add unique, descriptive title to <head> -->
<title>Primary Keyword - Secondary Keyword | Brand Name</title>
  • Keep 50-60 characters
  • Include target keywords at the beginning
  • Make unique for each page

Missing Meta Descriptions:

<!-- Add compelling description to <head> -->
<meta name="description" content="Clear, concise description that includes target keywords and encourages clicks. 150-160 characters.">

Missing H1 or Multiple H1s:

  • Ensure exactly ONE H1 per page
  • H1 should describe the main topic
  • Should match or relate to title tag

Images Without Alt Text:

<!-- Add descriptive alt text to all images -->
<img src="image.jpg" alt="Descriptive text explaining image content">

Missing HTML Lang Attribute:

<!-- Add to opening <html> tag -->
<html lang="en">

Priority 2: Important Optimizations

Viewport Meta Tag (critical for mobile SEO):

<meta name="viewport" content="width=device-width, initial-scale=1.0">

Charset Declaration:

<meta charset="UTF-8">

Open Graph Tags (for social media sharing):

<meta property="og:title" content="Your Page Title">
<meta property="og:description" content="Your page description">
<meta property="og:image" content="https://example.com/image.jpg">
<meta property="og:url" content="https://example.com/page-url">
<meta property="og:type" content="website">

Twitter Card Tags:

<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Your Page Title">
<meta name="twitter:description" content="Your page description">
<meta name="twitter:image" content="https://example.com/image.jpg">

Canonical URL:

<link rel="canonical" href="https://example.com/preferred-url">

Priority 3: Advanced Optimization

Schema Markup - Refer to references/schema_markup_guide.md for detailed implementation. Common types:

  • Organization (homepage)
  • Article/BlogPosting (blog posts)
  • LocalBusiness (local businesses)
  • Breadcrumb (navigation)
  • FAQ (FAQ pages)
  • Product (e-commerce)

Example implementation:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Article Title",
  "author": {
    "@type": "Person",
    "name": "Author Name"
  },
  "datePublished": "2024-01-15",
  "image": "https://example.com/image.jpg"
}
</script>

4. Generate or Update Sitemap

After fixing issues, generate an XML sitemap:

python scripts/generate_sitemap.py <directory> <base_url> [output_file]

Example:

# Generate sitemap for website
python scripts/generate_sitemap.py ./public https://example.com

# Specify output location
python scripts/generate_sitemap.py ./public https://example.com ./public/sitemap.xml

The script:

  • Automatically finds all HTML files
  • Generates proper URLs
  • Includes lastmod dates
  • Estimates priority and changefreq values
  • Creates properly formatted XML sitemap

After generation:

  1. Upload sitemap.xml to website root
  2. Add reference to robots.txt
  3. Submit to Google Search Console and Bing Webmaster Tools

5. Update robots.txt

Use the template from assets/robots.txt and customize:

User-agent: *
Allow: /

# Block sensitive directories
Disallow: /admin/
Disallow: /private/

# Reference your sitemap
Sitemap: https://yourdomain.com/sitemap.xml

Place robots.txt in website root directory.

6. Verify and Test

After implementing fixes:

Local Testing:

  1. Run the SEO analyzer again to verify fixes
  2. Check that all critical issues are resolved
  3. Ensure no new issues were introduced

Online Testing:

  1. Deploy changes to production
  2. Test with Google Rich Results Test: https://search.google.com/test/rich-results
  3. Validate schema markup: https://validator.schema.org/
  4. Check mobile-friendliness: https://search.google.com/test/mobile-friendly
  5. Monitor in Google Search Console

7. Ongoing Optimization

Regular maintenance:

  • Update sitemap when adding new pages
  • Keep meta descriptions fresh and compelling
  • Ensure new images have alt text
  • Add schema markup to new content types
  • Monitor Search Console for issues
  • Update content regularly

Common Optimization Patterns

Pattern 1: New Website Setup

For a brand new HTML/CSS website:

  1. Run initial analysis: python scripts/seo_analyzer.py ./public
  2. Add essential meta tags to all pages (title, description, viewport)
  3. Ensure proper heading structure (one H1 per page)
  4. Add alt text to all images
  5. Implement organization schema on homepage
  6. Generate sitemap: python scripts/generate_sitemap.py ./public https://yourdomain.com
  7. Create robots.txt from template
  8. Deploy and submit sitemap to search engines

Pattern 2: Existing Website Audit

For an existing website needing optimization:

  1. Run comprehensive analysis: python scripts/seo_analyzer.py ./public
  2. Identify and prioritize issues (critical first)
  3. Fix critical issues across all pages
  4. Add missing Open Graph and Twitter Card tags
  5. Implement schema markup for appropriate pages
  6. Regenerate sitemap with updates
  7. Verify fixes with analyzer
  8. Deploy and monitor

Pattern 3: Single Page Opt

how to use seo-optimizer

How to use seo-optimizer on Cursor

AI-first code editor with Composer

1

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

  • ›Cursor installed and configured on your development machine
  • ›Node.js version 16.0+ with npm package manager (verify with node --version)
  • ›Active project directory or workspace where you want to add seo-optimizer
2

Execute installation command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/ailabs-393/ai-labs-claude-skills --skill seo-optimizer

The skills CLI fetches seo-optimizer from GitHub repository ailabs-393/ai-labs-claude-skills and configures it for Cursor.

3

Select Cursor when prompted

The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:

◆ Which agents do you want to install to?
│
│ ── Universal (.agents/skills) ── always included ────
│ • Amp
│ • Antigravity
│ • Cline
│ • Codex
│ ●Cursor(selected)
│ • Cursor
│ • Windsurf
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/seo-optimizer

Reload or restart Cursor to activate seo-optimizer. Access the skill through slash commands (e.g., /seo-optimizer) or your agent's skill management interface.

⚠

Security & Verification Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.

Additional Resources

›View source code on GitHub›Skills CLI documentation›Learn more about Cursor›What are agent skills?

List & Monetize Your Skill

Submit your Claude Code skill and start earning

GET_STARTED →

Use Cases▌

Task Automation & Efficiency

Automate repetitive workflows and reduce manual effort

Example

Generate reports, summarize documents, draft communications

✓

Save 3-5 hours per week on routine tasks

Knowledge Enhancement

Learn new skills, understand complex topics, get expert guidance

Example

Explain concepts, provide examples, suggest learning resources

✓

Accelerate learning and skill development by 2x

Quality Improvement

Enhance output quality through reviews, suggestions, and refinements

Example

Review drafts, suggest improvements, catch errors

✓

Improve work quality by 30-40% with less effort

Implementation Guide▌

Prerequisites

  • ›Claude Desktop or compatible AI client with skill support
  • ›Clear understanding of task or problem to solve
  • ›Willingness to iterate and refine outputs

Time Estimate

15-45 minutes depending on use case complexity

Installation Steps

  1. 1.Install skill using provided installation command
  2. 2.Test with simple use case relevant to your work
  3. 3.Evaluate output quality and relevance
  4. 4.Iterate on prompts to improve results
  5. 5.Integrate into regular workflow if valuable

Common Pitfalls

  • ⚠Expecting perfect results without iteration
  • ⚠Not providing enough context in prompts
  • ⚠Using skill for tasks outside its intended scope
  • ⚠Accepting outputs without review and validation

Best Practices▌

✓ Do

  • +Start with clear, specific prompts
  • +Provide relevant context and constraints
  • +Review and refine all outputs before using
  • +Iterate to improve output quality
  • +Document successful prompt patterns

✗ Don't

  • −Don't use without understanding skill limitations
  • −Don't skip validation of outputs
  • −Don't share sensitive information in prompts
  • −Don't expect skill to replace human judgment

💡 Pro Tips

  • ★Be specific about desired format and style
  • ★Ask for multiple options to choose from
  • ★Request explanations to understand reasoning
  • ★Combine AI efficiency with human expertise

When to Use This▌

✓ Use When

Use when skill capabilities match your task, clear ROI on time saved, and you can validate outputs. Best for repetitive tasks, learning, and quality improvement.

✗ Avoid When

Avoid when task requires deep expertise you can't validate, involves sensitive decisions, or when learning process is more valuable than speed of completion.

Learning Path▌

  1. 1Familiarize yourself with skill capabilities and limitations
  2. 2Start with low-risk, non-critical tasks
  3. 3Progress to more complex and valuable use cases
  4. 4Build expertise through regular use and experimentation

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.5★★★★★52 reviews
  • ★★★★★Sakura Dixit· Dec 28, 2024

    Solid pick for teams standardizing on skills: seo-optimizer is focused, and the summary matches what you get after install.

  • ★★★★★Kiara Mensah· Dec 24, 2024

    Useful defaults in seo-optimizer — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • ★★★★★Omar Okafor· Dec 16, 2024

    seo-optimizer is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • ★★★★★Ira Singh· Dec 4, 2024

    seo-optimizer has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • ★★★★★Sakura Reddy· Nov 23, 2024

    seo-optimizer reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • ★★★★★Nia White· Nov 19, 2024

    I recommend seo-optimizer for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • ★★★★★Nia Thompson· Nov 11, 2024

    Registry listing for seo-optimizer matched our evaluation — installs cleanly and behaves as described in the markdown.

  • ★★★★★Diya White· Nov 7, 2024

    Keeps context tight: seo-optimizer is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • ★★★★★Isabella Bansal· Oct 26, 2024

    I recommend seo-optimizer for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • ★★★★★Nia Jackson· Oct 14, 2024

    We added seo-optimizer from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

showing 1-10 of 52

1 / 6