/seo-optimizer
This skill should be used when analyzing HTML/CSS websites for SEO optimization, fixing SEO issues, generating SEO reports, or implementing SEO best practices. Use when the user requests SEO audits, optimization, meta tag improvements, schema markup implementation, sitemap
$ npx -y skills add ailabs-393/ai-labs-claude-skills --skill seo-optimizer --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/seo-optimizer
Context preview
The summary Claude sees to decide when to auto-load this skill.
This skill should be used when analyzing HTML/CSS websites for SEO optimization, fixing SEO issues, generating SEO reports, or implementing SEO best practices. Use when the user requests SEO audits, optimization, meta tag improvements, schema markup implementation, sitemap
SKILL.md
seo-optimizer.SKILL.mdname: seo-optimizer
description: This skill should be used when analyzing HTML/CSS websites for SEO optimization, fixing SEO issues, generating SEO reports, or implementing SEO best practices. Use when the user requests SEO audits, optimization, meta tag improvements, schema markup implementation, sitemap generation, or general search engine optimization tasks.
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 T
Read more
name: seo-optimizer description: This skill should be used when analyzing HTML/CSS websites for SEO optimization, fixing SEO issues, generating SEO reports, or implementing SEO best practices. Use when the user requests SEO audits, optimization, meta tag improvements, schema markup implementation, sitemap generation, or general search engine optimization tasks.
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 T
🧠 A collection of reusable "skills" for Claude AI and developer tooling. Each skill is a focused, modular package that brings automation to your dev workflows — from SEO analysis to document parsing, CI/CD generation, Docker automation, and more.
Repo: ailabs-393/ai-labs-claude-skills
Other skills on ai-labs-claude-skills.
- /brand-analyzer
This skill should be used when the user requests brand analysis, brand guidelines creation, brand audits, or establishing brand identity and consistency standards. It provides comprehensive frameworks for analyzing brand elements and creating actionable brand guidelines based on
Open skill - /business-analytics-reporter
This skill should be used when analyzing business sales and revenue data from CSV files to identify weak areas, generate statistical insights, and provide strategic improvement recommendations. Use when the user requests a business performance report, asks to analyze sales data,
Open skill - /business-document-generator
This skill should be used when the user requests to create professional business documents (proposals, business plans, or budgets) from templates. It provides PDF templates and a Python script for generating filled documents from user data.
Open skill - /cicd-pipeline-generator
This skill should be used when creating or configuring CI/CD pipeline files for automated testing, building, and deployment. Use this for generating GitHub Actions workflows, GitLab CI configs, CircleCI configs, or other CI/CD platform configurations. Ideal for setting up
Open skill - /codebase-documenter
This skill should be used when writing documentation for codebases, including README files, architecture documentation, code comments, and API documentation. Use this skill when users request help documenting their code, creating getting-started guides, explaining project
Open skill - /csv-data-visualizer
This skill should be used when working with CSV files to create interactive data visualizations, generate statistical plots, analyze data distributions, create dashboards, or perform automatic data profiling. It provides comprehensive tools for exploratory data analysis using
Open skill