All skills
ailabs-393 avatar

/seo-optimizer

@7d5342d

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.

Use this Skill: https://skilld.dev/gh/ailabs-393/ai-labs-claude-skills/seo-optimizer

This session only. Nothing lands on disk.

referencesseo_checklist.md

≈2.8k tokens on demand. Your agent reads this file only when SKILL.md points to it.

SEO Optimization Checklist

Comprehensive guide for optimizing HTML/CSS websites for search engines.

1. Title Tags

Critical for SEO - Title tags are one of the most important on-page SEO elements.

Requirements:

  • Must have: Every page needs a unique <title> tag
  • Optimal length: 50-60 characters (about 600 pixels)
  • Format: Primary Keyword - Secondary Keyword | Brand Name
  • Placement: Inside <head> section

Best Practices:

  • Place most important keywords at the beginning
  • Make titles compelling and click-worthy
  • Avoid keyword stuffing
  • Each page should have a unique title
  • Include brand name at the end for brand recognition

Example:

<title>Best SEO Practices for HTML Websites | YourBrand</title>

2. Meta Descriptions

Important for CTR - While not a direct ranking factor, meta descriptions influence click-through rates.

Requirements:

  • Optimal length: 150-160 characters
  • Must be unique: Each page should have different description
  • Include CTA: Add call-to-action when appropriate
  • Format: <meta name="description" content="...">

Best Practices:

  • Summarize page content accurately
  • Include target keywords naturally
  • Make it compelling to encourage clicks
  • Avoid duplicate descriptions across pages
  • Write for humans, not just search engines

Example:

<meta name="description" content="Learn essential SEO practices for HTML websites. Improve rankings with our comprehensive guide covering meta tags, headings, and technical optimization.">

3. Heading Structure (H1-H6)

Critical for content hierarchy - Proper heading structure helps search engines understand content organization.

Requirements:

  • Exactly one H1: Each page should have one (and only one) H1 tag
  • Logical hierarchy: Use H2-H6 in descending order
  • Include keywords: Incorporate relevant keywords naturally
  • Descriptive: Headings should clearly describe the section content

Structure Guidelines:

<h1>Main Page Title (Only One Per Page)</h1>
  <h2>Major Section</h2>
    <h3>Subsection</h3>
    <h3>Another Subsection</h3>
  <h2>Another Major Section</h2>
    <h3>Subsection</h3>
      <h4>Detail Level</h4>

Best Practices:

  • H1 should match or closely relate to the title tag
  • Don't skip heading levels (e.g., H2 to H4)
  • Use headings to break up content for readability
  • Make headings descriptive and meaningful

4. Image Optimization

Critical for accessibility and SEO - Images need proper optimization for both search engines and users.

Requirements:

  • Alt text: Every image must have an alt attribute
  • File names: Use descriptive, keyword-rich file names
  • File size: Optimize images for fast loading
  • Format: Use appropriate format (WebP, JPEG, PNG)

Alt Text Best Practices:

  • Describe the image content accurately
  • Include relevant keywords naturally
  • Keep it concise (125 characters or less)
  • Leave alt empty for decorative images (alt="")
  • Don't start with "Image of" or "Picture of"

Example:

<!-- Good -->
<img src="responsive-web-design-example.jpg"
     alt="Responsive web design showing mobile, tablet, and desktop layouts">

<!-- Bad -->
<img src="img123.jpg" alt="">
<img src="image.jpg" alt="Image of responsive design picture">

Image Optimization:

  • Compress images without losing quality
  • Use responsive images with srcset
  • Implement lazy loading for below-fold images
  • Add width and height attributes to prevent layout shift
<img src="image.jpg"
     alt="Description"
     width="800"
     height="600"
     loading="lazy">

5. URL Structure

Important for usability and SEO - Clean, descriptive URLs are easier to understand and rank better.

Best Practices:

  • Use hyphens to separate words (not underscores)
  • Keep URLs short and descriptive
  • Include target keywords
  • Use lowercase letters
  • Avoid special characters and parameters when possible

Examples:

✅ Good: https://example.com/seo-best-practices
✅ Good: https://example.com/blog/html-optimization
❌ Bad: https://example.com/page?id=123&cat=456
❌ Bad: https://example.com/Blog_Post_Title

6. Internal Linking

Important for navigation and SEO - Internal links help search engines discover content and establish site hierarchy.

Best Practices:

  • Use descriptive anchor text
  • Link to related content
  • Create a logical site structure
  • Ensure important pages are easily accessible
  • Use breadcrumb navigation

Example:

<!-- Good -->
<a href="/seo-guide/meta-tags">Learn about meta tags for SEO</a>

<!-- Bad -->
<a href="/page2.html">Click here</a>

7. Page Speed & Performance

Critical ranking factor - Fast-loading pages rank better and provide better user experience.

Optimization Techniques:

  • Minify HTML, CSS, and JavaScript
  • Enable GZIP compression
  • Optimize images
  • Leverage browser caching
  • Use a Content Delivery Network (CDN)
  • Eliminate render-blocking resources
  • Reduce server response time

HTML Optimizations:

<!-- Preload critical resources -->
<link rel="preload" href="critical.css" as="style">

<!-- Defer non-critical JavaScript -->
<script src="script.js" defer></script>

<!-- Lazy load images -->
<img src="image.jpg" loading="lazy" alt="Description">

8. Mobile Optimization

Critical ranking factor - Google uses mobile-first indexing.

Requirements:

  • Viewport meta tag: Must be present
  • Responsive design: Site must work on all devices
  • Touch-friendly: Buttons and links properly sized
  • Fast loading: Mobile performance is crucial

Essential Meta Tag:

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

Best Practices:

  • Use responsive CSS (media queries, flexbox, grid)
  • Test on multiple devices and screen sizes
  • Ensure text is readable without zooming
  • Make tap targets at least 48x48 pixels
  • Avoid intrusive interstitials

9. Semantic HTML

Important for accessibility and SEO - Semantic HTML helps search engines understand content meaning.

Use Semantic Tags:

<header>Site header with logo and navigation</header>
<nav>Main navigation menu</nav>
<main>
  <article>Main content</article>
  <aside>Sidebar content</aside>
</main>
<footer>Site footer</footer>

Benefits:

  • Better content understanding by search engines
  • Improved accessibility for screen readers
  • Cleaner, more maintainable code

10. Schema Markup (Structured Data)

Important for rich results - Schema markup helps search engines display rich snippets.

Common Schema Types:

  • Article: Blog posts, news articles
  • Organization: Company information
  • LocalBusiness: Local business information
  • Product: Product pages
  • Breadcrumb: Breadcrumb navigation
  • FAQ: Frequently asked questions

Example (JSON-LD format):

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "SEO Best Practices for HTML Websites",
  "author": {
    "@type": "Person",
    "name": "John Doe"
  },
  "datePublished": "2024-01-15",
  "image": "https://example.com/article-image.jpg"
}
</script>

11. Canonical URLs

Important for duplicate content - Canonical tags prevent duplicate content issues.

Usage:

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

When to Use:

  • Pages accessible via multiple URLs
  • Similar content on different pages
  • Parameter-based URLs
  • HTTP and HTTPS versions of same page

12. Robots Meta Tag

Controls indexing - Tells search engines how to index the page.

Common Values:

<!-- Allow indexing and following links (default) -->
<meta name="robots" content="index, follow">

<!-- Prevent indexing -->
<meta name="robots" content="noindex, follow">

<!-- Prevent following links -->
<meta name="robots" content="index, nofollow">

<!-- Prevent indexing and following -->
<meta name="robots" content="noindex, nofollow">

13. Open Graph Tags

Important for social sharing - Controls how content appears when shared on social media.

Essential Open Graph Tags:

<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">
<meta property="og:type" content="website">

14. Twitter Card Tags

Important for Twitter sharing - Controls how content appears on Twitter.

Essential 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">

15. Language Declaration

Important for international SEO - Declares the page language.

Requirements:

<html lang="en">

For Multi-language Sites:

<!-- Alternate language versions -->
<link rel="alternate" hreflang="en" href="https://example.com/en/">
<link rel="alternate" hreflang="es" href="https://example.com/es/">

16. Content Quality

Most important ranking factor - Quality content is essential for SEO success.

Best Practices:

  • Write for humans first, search engines second
  • Provide comprehensive, valuable information
  • Keep content fresh and updated
  • Use natural language and avoid keyword stuffing
  • Aim for at least 300 words per page (more for important pages)
  • Include multimedia (images, videos) when appropriate
  • Break up content with headings and lists for readability

17. Technical SEO Checklist

Essential Files:

robots.txt:

User-agent: *
Allow: /
Sitemap: https://example.com/sitemap.xml

sitemap.xml:

  • Generate XML sitemap listing all pages
  • Submit to search engines
  • Update regularly

Security:

  • Use HTTPS (SSL certificate)
  • Secure forms and user data
  • Keep software updated

Crawlability:

  • Fix broken links (404 errors)
  • Create logical site structure
  • Use internal linking effectively
  • Ensure all pages are accessible

Quick Reference Priority List

Critical (Fix Immediately):

  1. ✅ Unique title tag on every page (50-60 chars)
  2. ✅ Meta description on every page (150-160 chars)
  3. ✅ Exactly one H1 per page
  4. ✅ Alt text on all images
  5. ✅ Mobile viewport meta tag
  6. ✅ HTTPS enabled
  7. ✅ HTML lang attribute

Important (Fix Soon):

  1. ⚠️ Proper heading hierarchy (H1-H6)
  2. ⚠️ Open Graph tags
  3. ⚠️ Twitter Card tags
  4. ⚠️ Canonical URLs
  5. ⚠️ XML sitemap
  6. ⚠️ Robots.txt
  7. ⚠️ Schema markup

Recommended (Optimize Over Time):

  1. 📊 Page speed optimization
  2. 📊 Internal linking strategy
  3. 📊 Content quality and freshness
  4. 📊 URL structure optimization
  5. 📊 Image optimization
  6. 📊 Semantic HTML usage

Source: SKILL.md on GitHub

1 warning15d5 checks · Risk SAFE
  • Gen Agent Trust Hub15d

    The SEO Optimizer skill provides a suite of tools for analyzing HTML websites and generating sitemaps. It uses local Python scripts to audit metadata and hierarchy, following industry standards. No malicious code, dangerous dependencies, or safety bypasses were found.

  • Socket15d

    No alerts

  • Snyk15d

    Risk: LOW · No issues

  • Runlayer7mo

    8/8 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 7d5342d. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Dormantupdated 11 months ago

README badge

README badge for ailabs-393/ai-labs-claude-skills/seo-optimizer