peakdong68peakdong68/my-skills/skills/seo-optimizer/SKILL.md

seo-optimizer

Skill0 starsChanged 3 months agoMITView on GitHub

Use when the user needs technical SEO audits, meta tag optimization, structured data markup, Core Web Vitals improvement, or search engine visibility enhancement. Trigger conditions: site audit request, meta tag review, Schema.org implementation, page speed optimization, indexability issues, sitemap or robots.txt configuration, hreflang setup, Open Graph or Twitter Card tags, rich snippet eligibility.

19 other projects use a version of this.

Adopted by

Most recently taken up by

awaik/direct-mcp-ai-projecttheir own version, first seen Nov 1, 2026
yeer0s/ultimate-seo-collectiontheir own version, first seen Oct 15, 2026
TheArchitectit/awesome-cline-skillstheir own version, first seen Oct 13, 2026
SkillMedev/seo-organic-growththeir own version, first seen Oct 5, 2026
OneWave-AI/onewave-toolkittheir own version, first seen Oct 2, 2026
OneWave-AI/claude-skillstheir own version, first seen Sep 21, 2026

Other versions19 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 19
claude-office-skills/skills★ 433same name
OneWave-AI/claude-skills★ 378same name
hamzafarooq/claude-code-starter★ 145same name
chongdashu/cc-skills★ 29same name
awaik/direct-mcp-ai-project★ 17same name
ckorhonen/claude-skills★ 17same name
jackson-video-resources/skills★ 17same name
TheArchitectit/awesome-cline-skills★ 8same name
madeinlowcode/skills-claude-code★ 7same name
basejb/skills★ 5same name
9 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository24 other files it gives its agents.
- in-progress/AGENTS.mdAGENTS.md
- test-skills/AGENTS.mdAGENTS.md
- docx-processingSkill
- email-composerSkill
- fastapi-expertSkill
- fastapiSkill
- frontend-code-reviewSkill
- frontend-testingSkill
- laravel-boostSkill
- laravel-specialistSkill
- migrate-radix-to-baseSkill
- pdf-processingSkill
- php-specialistSkill
- python-proSkill
- react-expertSkill
- rust-engineerSkill
- shadcn-code-reviewSkill
- shadcnSkill
- tailwind-v4Skill
- tauri-developmentSkill
- tauri-v2Skill
- typescript-proSkill
- xlsx-processingSkill
- zustand-stateSkill

The file

We split this skill into the rules it gives an agent

12 rules. 0 are common, 11 are distinctive, and 1 is very specific to this project.

0
Common
Most of the 15 edited versions we read keep these.
11
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Distinctive:
Check robots.txt and XML sitemap validity
line 24
Distinctive:
Verify canonical URLs and duplicate content handling
line 26
Distinctive:
Check HTTPS implementation and mixed content
line 28
Distinctive:
Check URL structure (short, descriptive, hyphenated)
line 40
Distinctive:
Test for rich snippet eligibility
line 50
Distinctive:
Use sitemap index for larger sites
line 303
Very specific:
Update lastmod only when content genuinely changes
line 305
Distinctive:
Do NOT skip the technical audit because "the site looks fine" -- crawl it.
line 386
Distinctive:
Do NOT add structured data without validating it passes the Rich Results Test.
line 387
Distinctive:
Do NOT assume meta tags are correct without checking every page type.
line 388
Distinctive:
Do NOT deploy SEO changes without before/after measurement.
line 389
Distinctive:
Do NOT optimize for search engines at the expense of user experience.
line 390

“Common” is measured: kept by at least 6 in 10 of the 15 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

SKILL.md

SEO Optimizer

Overview

Optimize websites for search engine visibility through technical SEO, on-page optimization, structured data implementation, and Core Web Vitals performance tuning. This skill covers crawlability, indexability, meta tag strategy, Schema.org markup, sitemap generation, canonical URL management, internationalization (hreflang), and performance optimization for Google's ranking signals.

Apply this skill whenever a site needs better organic search performance, whether for a single page audit or a full-site overhaul.

Multi-Phase Process

Phase 1: Technical Audit

Crawl the site (Screaming Frog, Sitebulb, or custom script)
Check robots.txt and XML sitemap validity
Identify crawl errors, redirect chains, and broken links
Verify canonical URLs and duplicate content handling
Assess mobile-friendliness and responsive design
Check HTTPS implementation and mixed content
Evaluate page load performance (Core Web Vitals)

STOP — Do NOT proceed to Phase 2 until audit findings are documented and prioritized.

Phase 2: On-Page Optimization

Audit title tags (unique, 50-60 chars, keyword placement)
Review meta descriptions (unique, 150-160 chars, compelling CTAs)
Analyze heading hierarchy (single H1, logical H2-H6 structure)
Optimize image alt text and file names
Review internal linking structure and anchor text
Check URL structure (short, descriptive, hyphenated)
Validate Open Graph and Twitter Card tags

STOP — Do NOT proceed to Phase 3 until on-page changes are implemented and verified.

Phase 3: Structured Data Implementation

Identify applicable Schema.org types for content
Implement JSON-LD structured data
Validate with Google Rich Results Test
Test for rich snippet eligibility
Monitor Search Console for structured data errors

STOP — Do NOT proceed to Phase 4 until structured data passes validation.

Phase 4: Monitoring and Iteration

Set up Google Search Console monitoring
Track Core Web Vitals over time
Monitor indexation status and coverage
Review search performance (clicks, impressions, CTR, position)
Set up alerts for crawl errors and ranking drops

Audit Priority Decision Table

Finding	Severity	Fix Priority	Impact
No HTTPS / mixed content	Critical	Immediate	Ranking penalty, trust signals
Missing canonical URLs	Critical	Immediate	Duplicate content dilution
Broken redirect chains (3+ hops)	High	This sprint	Crawl budget waste, link equity loss
Missing or duplicate title tags	High	This sprint	CTR drop, ranking confusion
No structured data	Medium	Next sprint	Missing rich snippets
Missing alt text on images	Medium	Next sprint	Accessibility and image search loss
Suboptimal Core Web Vitals	Medium	Next sprint	Ranking signal, user experience
Missing hreflang tags (multi-language)	Low	Backlog	Geo-targeting issues
Non-descriptive URL slugs	Low	Backlog	Minor ranking and CTR effect

Meta Tag Reference

Essential Meta Tags

<head>
  <!-- Primary -->
  <title>Primary Keyword - Secondary Keyword | Brand Name</title>
  <meta name="description" content="Compelling 150-160 char description with target keyword and clear value proposition.">
  <link rel="canonical" href="https://example.com/page">

  <!-- Robots -->
  <meta name="robots" content="index, follow">
  <!-- or noindex, nofollow for pages that shouldn't be indexed -->

  <!-- Viewport (mobile) -->
  <meta name="viewport" content="width=device-width, initial-scale=1">

  <!-- Open Graph -->
  <meta property="og:type" content="website">
  <meta property="og:title" content="Page Title for Social Sharing">
  <meta property="og:description" content="Description optimized for social sharing.">
  <meta property="og:image" content="https://example.com/og-image.jpg">
  <meta property="og:url" content="https://example.com/page">
  <meta property="og:site_name" content="Brand Name">

  <!-- Twitter Card -->
  <meta name="twitter:card" content="summary_large_image">
  <meta name="twitter:title" content="Page Title">
  <meta name="twitter:description" content="Twitter-optimized description.">
  <meta name="twitter:image" content="https://example.com/twitter-image.jpg">

  <!-- Internationalization -->
  <link rel="alternate" hreflang="en" href="https://example.com/en/page">
  <link rel="alternate" hreflang="de" href="https://example.com/de/page">
  <link rel="alternate" hreflang="x-default" href="https://example.com/page">
</head>

Meta Tag Optimization Matrix

Element	Max Length	Priority Keywords	Common Mistakes
Title tag	50-60 chars	Front-load primary keyword	Too long, keyword stuffing, duplicate
Meta description	150-160 chars	Include CTA and keyword	Missing, duplicate, no CTA
H1	N/A (single per page)	Primary keyword variation	Multiple H1s, missing H1
URL slug	3-5 words	Target keyword	Too long, parameters, underscores
Image alt	125 chars	Descriptive, keyword if natural	Empty, "image of...", keyword stuffing
OG title	60-90 chars	Engaging, shareable	Same as title tag (missed opportunity)

Structured Data (JSON-LD)

Article

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How to Optimize Core Web Vitals",
  "author": {
    "@type": "Person",
    "name": "Jane Smith",
    "url": "https://example.com/authors/jane-smith"
  },
  "datePublished": "2026-03-01",
  "dateModified": "2026-03-15",
  "image": "https://example.com/images/article-hero.jpg",
  "publisher": {
    "@type": "Organization",
    "name": "Example Blog",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/logo.png"
    }
  },
  "description": "A comprehensive guide to improving LCP, FID, and CLS scores."
}
</script>

Product

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Widget Pro",
  "description": "Professional-grade widget for enterprise use.",
  "image": "https://example.com/widget-pro.jpg",
  "brand": { "@type": "Brand", "name": "WidgetCo" },
  "offers": {
    "@type": "Offer",
    "price": "49.99",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "url": "https://example.com/widget-pro"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "312"
  }
}
</script>

FAQ Page

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is Core Web Vitals?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Core Web Vitals are a set of metrics that measure real-world user experience for loading, interactivity, and visual stability."
      }
    }
  ]
}
</script>

Schema Type Decision Guide

Content Type	Schema Type	Rich Result
Blog post	Article	Article snippet
Product page	Product	Price, rating, availability
FAQ section	FAQPage	Expandable Q&A
How-to guide	HowTo	Step-by-step snippet
Recipe	Recipe	Image, time, rating
Event	Event	Date, location, price
Local business	LocalBusiness	Map pack, hours
Software	SoftwareApplication	Rating, price
Breadcrumbs	BreadcrumbList	Breadcrumb trail
Video	VideoObject	Thumbnail, duration

Core Web Vitals

Metrics and Thresholds

Metric	Good	Needs Improvement	Poor	Measures
LCP (Largest Contentful Paint)	<= 2.5s	<= 4.0s	> 4.0s	Loading performance
INP (Interaction to Next Paint)	<= 200ms	<= 500ms	> 500ms	Interactivity
CLS (Cumulative Layout Shift)	<= 0.1	<= 0.25	> 0.25	Visual stability

LCP Optimization

<!-- Preload hero image -->
<link rel="preload" as="image" href="/hero.webp" fetchpriority="high">

<!-- Use modern image formats -->
<picture>
  <source srcset="/hero.avif" type="image/avif">
  <source srcset="/hero.webp" type="image/webp">
  <img src="/hero.jpg" alt="Hero description" width="1200" height="600"
       fetchpriority="high" decoding="async">
</picture>

CLS Prevention

/* Always set dimensions on images and video */
img, video {
  width: 100%;
  height: auto;
  aspect-ratio: 16 / 9;
}

/* Reserve space for dynamic content */
.ad-slot {
  min-height: 250px;
}

/* Avoid inserting content above existing content */
.notification-bar {
  position: fixed; /* doesn't shift layout */
}

INP Optimization

// Break long tasks with yield
async function processLargeDataset(data) {
  for (let i = 0; i < data.length; i++) {
    processItem(data[i]);
    if (i % 100 === 0) {
      await new Promise(resolve => setTimeout(resolve, 0)); // yield to main thread
    }
  }
}

// Use requestIdleCallback for non-critical work
requestIdleCallback(() => {
  loadAnalytics();
  initNonCriticalFeatures();
});

XML Sitemap

Generation Pattern

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://example.com/</loc>
    <lastmod>2026-03-15</lastmod>
    <changefreq>daily</changefreq>
    <priority>1.0</priority>
  </url>
  <url>
    <loc>https://example.com/products</loc>
    <lastmod>2026-03-14</lastmod>
    <changefreq>weekly</changefreq>
    <priority>0.8</priority>
  </url>
</urlset>

Sitemap Best Practices

Maximum 50,000 URLs per sitemap file
Use sitemap index for larger sites
Include only canonical, indexable URLs
Update lastmod only when content genuinely changes
Submit via Google Search Console and robots.txt

robots.txt Template

User-agent: *
Allow: /
Disallow: /admin/
Disallow: /api/
Disallow: /search?
Disallow: /*?sort=
Disallow: /*?filter=

Sitemap: https://example.com/sitemap.xml

Next.js / React SEO Patterns

Next.js Metadata API (App Router)

import type { Metadata } from 'next';

export const metadata: Metadata = {
  title: {
    template: '%s | Brand Name',
    default: 'Brand Name - Tagline',
  },
  description: 'Site-wide default description.',
  openGraph: {
    type: 'website',
    locale: 'en_US',
    url: 'https://example.com',
    siteName: 'Brand Name',
  },
  twitter: {
    card: 'summary_large_image',
  },
  robots: {
    index: true,
    follow: true,
  },
  alternates: {
    canonical: 'https://example.com',
  },
};

Dynamic Metadata per Page

export async function generateMetadata({ params }): Promise<Metadata> {
  const product = await getProduct(params.slug);

  return {
    title: product.name,
    description: product.description.slice(0, 160),
    openGraph: {
      title: product.name,
      description: product.description.slice(0, 200),
      images: [{ url: product.image, width: 1200, height: 630 }],
    },
  };
}

Anti-Patterns / Common Mistakes

Anti-Pattern	Why It Fails	What To Do Instead
Keyword stuffing in titles/content	Triggers spam filters, reduces CTR	Use primary keyword once naturally, add variations
Same title/description across pages	Duplicate content signals, wasted opportunity	Unique, page-specific meta for every indexable URL
Blocking CSS/JS in robots.txt	Googlebot cannot render pages	Allow all rendering resources
Structured data mismatching page content	Google penalties, rich snippet removal	Schema must reflect visible content exactly
Redirect chains > 2 hops	Crawl budget waste, link equity loss	Redirect directly to final destination
JS-only navigation without SSR links	Crawler cannot discover pages	Server-render navigation links
Ignoring Core Web Vitals	Ranking signal degradation	Profile and optimize LCP, INP, CLS
Missing canonical URLs	Duplicate content penalties	Set canonical on every indexable page
Over-optimized anchor text	Unnatural link patterns trigger penalties	Use descriptive, varied anchor text
Hiding content with CSS for SEO	Cloaking violation	All SEO content must be visible to users

Anti-Rationalization Guards

Do NOT skip the technical audit because "the site looks fine" -- crawl it.
Do NOT add structured data without validating it passes the Rich Results Test.
Do NOT assume meta tags are correct without checking every page type.
Do NOT deploy SEO changes without before/after measurement.
Do NOT optimize for search engines at the expense of user experience.

Integration Points

Skill	How It Connects
`content-creator`	SEO informs keyword targeting and headline strategy for marketing content
`content-research-writer`	Research-backed content needs SEO-optimized structure and meta tags
`senior-frontend`	Core Web Vitals optimization requires frontend performance tuning
`performance-optimization`	Page speed directly affects LCP and INP scores
`deployment`	SEO changes need proper cache invalidation and redirect configuration
`tech-docs-generator`	Documentation sites need sitemap, canonical, and structured data setup

Skill Type

FLEXIBLE — Adapt the optimization strategy to the site's technology stack, content type, and competitive landscape. Technical SEO fundamentals and structured data best practices are strongly recommended; specific implementation patterns vary by framework.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free