Agent skill

SEO Optimization

by seb1n in seb1n/awesome-ai-agent-skills

Optimize a webpage for search engines by analyzing on-page elements, improving technical performance, and implementing structured data for maximum visibility.

MITAuto-check passedMarketing & SEO

Install SEO Optimization

skills CLI
$ npx skills add seb1n/awesome-ai-agent-skills --skill seo-optimization -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install seb1n/awesome-ai-agent-skills seo-optimization --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/seb1n/awesome-ai-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/marketing-and-seo/seo-optimization .claude/skills/seo-optimization && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
seo-optimization
GitHub stars
206
Token cost
~1.9k tokens
SKILL.md length
833 words
Files
1
Skills in repo
92
Repo updated
First seen
Licence
MIT

At a glance

Optimize a webpage for search engines by analyzing on-page elements, improving technical performance, and implementing structured data for maximum visibility.

  • Works in 6 steps: Crawl and inventory the page. Fetch the… → Analyze on-page SEO elements. Evaluate… → Evaluate technical SEO factors. Assess… → …
  • The user requests seo optimization
  • SKILL.md covers Workflow, Usage, Examples and Best Practices, plus 1 more section
  • Reaches acme.com and schema.org

What it does

SEO Optimization is an agent skill from seb1n/awesome-ai-agent-skills. Optimize a webpage for search engines by analyzing on-page elements, improving technical performance, and implementing structured data for maximum visibility. Use when the user requests seo optimization or provides relevant inputs for this workflow.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Schema markup, On-page SEO and Technical SEO. The repository describes itself as: 103 ready-to-use AI agent skills for Claude Code, OpenAI Codex, Gemini CLI, Cursor, GitHub Copilot, Windsurf, and other Agent Skills-compatible tools. Complete SKILL.md… The licence is MIT.

When your agent uses it

  • The user requests seo optimization
  • Provides relevant inputs for this workflow

Example prompts

  • “/seo-optimization”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Crawl and inventory the page. Fetch the target URL and parse the full HTML document. Extract the title tag, meta description, canonical…
  2. Analyze on-page SEO elements. Evaluate the title tag for length (50–60 characters), keyword placement, and uniqueness. Check the meta…
  3. Evaluate technical SEO factors. Assess Core Web Vitals — Largest Contentful Paint (LCP < 2.5s), First Input Delay (FID < 100ms), and…
  4. Implement structured data markup. Generate JSON-LD schema markup appropriate to the page type — Article, Product, FAQ, BreadcrumbList…
  5. Audit internal linking and content depth. Map the internal link graph to identify orphan pages and shallow content clusters. Recommend…
  6. Generate a prioritized SEO report. Produce a structured report with findings organized by impact (critical, high, medium, low). Include…

What it can do on your machine

Read from SKILL.md and the folder at commit 75865a5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are html).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • acme.com
    • schema.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

SEO Optimization loads about 1.9k tokens when it runs. Until then it costs about 67 tokens; SKILL.md has 833 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~67
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from seb1n/awesome-ai-agent-skills at commit 75865a5, republished under its MIT licence (© seb1n). 833 words, ~1,912 tokens.

Download SKILL.mdSave it as .claude/skills/seo-optimization/SKILL.md (or your agent's skills folder).
name
seo-optimization
description
Optimize a webpage for search engines by analyzing on-page elements, improving technical performance, and implementing structured data for maximum visibility. Use when the user requests seo optimization or provides relevant inputs for this workflow.
license
MIT
metadata.author
awesome-ai-agent-skills
metadata.version
1.0.0

SEO Optimization

This skill enables an AI agent to perform comprehensive search engine optimization on any webpage or website. The agent audits on-page factors (title tags, meta descriptions, headings, internal links), evaluates technical SEO health (Core Web Vitals, mobile-first indexing, crawlability), and implements structured data markup. The goal is to produce actionable recommendations that improve organic search rankings and click-through rates.

Workflow

  1. Crawl and inventory the page. Fetch the target URL and parse the full HTML document. Extract the title tag, meta description, canonical URL, Open Graph tags, all heading elements (H1–H6), images with alt attributes, and every internal and external link. Record the HTTP status code, response time, and redirect chain if applicable.

  2. Analyze on-page SEO elements. Evaluate the title tag for length (50–60 characters), keyword placement, and uniqueness. Check the meta description for length (150–160 characters) and compelling call-to-action language. Verify there is exactly one H1 tag that contains the primary keyword, and that H2–H4 tags form a logical content hierarchy. Flag missing alt text on images and broken internal links.

  3. Evaluate technical SEO factors. Assess Core Web Vitals — Largest Contentful Paint (LCP < 2.5s), First Input Delay (FID < 100ms), and Cumulative Layout Shift (CLS < 0.1). Check mobile-friendliness by analyzing the viewport meta tag and responsive layout. Verify the existence and correctness of robots.txt, XML sitemap, canonical tags, and hreflang tags for international sites. Identify render-blocking resources and unused CSS/JS.

  4. Implement structured data markup. Generate JSON-LD schema markup appropriate to the page type — Article, Product, FAQ, BreadcrumbList, Organization, or LocalBusiness. Validate the markup against Google's Rich Results requirements. Ensure the schema references match the visible page content to avoid structured data penalties.

  5. Audit internal linking and content depth. Map the internal link graph to identify orphan pages and shallow content clusters. Recommend anchor text improvements and suggest new internal links that strengthen topical authority. Evaluate content length and keyword density relative to top-ranking competitors.

  6. Generate a prioritized SEO report. Produce a structured report with findings organized by impact (critical, high, medium, low). Include before/after code snippets for recommended changes, estimated effort for each fix, and expected ranking impact. Provide a checklist format so engineers and content teams can track completion.

Usage

Provide the agent with the URL of the webpage to optimize and, optionally, the target keyword. The agent will return a full audit report with actionable fixes.

Prompt: Optimize the following page for the keyword "project management tools": https://example.com/blog/best-pm-tools

Examples

Example 1: Blog Post On-Page Optimization

Request: Optimize https://acme.com/blog/remote-work-tips for the keyword "remote work tips".

Before — HTML head:

html
<head>
  <title>Blog Post | Acme Co</title>
  <meta name="description" content="Read our latest blog post.">
</head>

After — Optimized HTML head:

html
<head>
  <title>15 Remote Work Tips That Boost Productivity in 2025 | Acme Co</title>
  <meta name="description" content="Discover 15 proven remote work tips to stay productive, manage your time, and avoid burnout. Backed by research from 500+ distributed teams.">
  <link rel="canonical" href="https://acme.com/blog/remote-work-tips">
  <meta property="og:title" content="15 Remote Work Tips That Boost Productivity">
  <meta property="og:description" content="Proven strategies from 500+ distributed teams.">
  <meta property="og:type" content="article">
  <script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "Article",
    "headline": "15 Remote Work Tips That Boost Productivity in 2025",
    "author": { "@type": "Person", "name": "Jane Smith" },
    "datePublished": "2025-03-10",
    "description": "Proven remote work tips backed by research from 500+ distributed teams."
  }
  </script>
</head>
Example 2: Technical SEO Audit Findings

Request: Run a technical SEO audit on https://acme.com.

Audit Report:

PriorityIssueDetailsFix
CriticalMissing XML sitemapNo sitemap found at /sitemap.xml; 40% of pages not indexedGenerate and submit sitemap to Search Console
CriticalLCP = 4.8s on mobileHero image is 2.4 MB uncompressed PNGConvert to WebP, add width/height, use loading="lazy"
HighDuplicate title tags12 pages share the title "Acme Co — Home"Write unique, keyword-rich titles for each page
HighMissing canonical tags8 pages lack <link rel="canonical">, causing index bloatAdd self-referencing canonicals to every page
MediumNo robots.txtEntire site crawlable including /admin and /stagingCreate robots.txt disallowing private paths
LowImages missing alt text34 of 120 images have empty alt attributesAdd descriptive alt text with relevant keywords
Show full SKILL.md (271 more words)Show less

Best Practices

  • Write for humans first, search engines second. Keyword stuffing degrades user experience and triggers ranking penalties. Aim for natural keyword integration at 1–2% density.
  • Prioritize Core Web Vitals. Google uses LCP, FID, and CLS as direct ranking signals. Compress images, defer non-critical JS, and set explicit dimensions on media elements.
  • Use self-referencing canonical tags on every page. This prevents duplicate content issues caused by URL parameters, trailing slashes, or session IDs.
  • Build topical authority through internal linking. Link related content in clusters around pillar pages. Use descriptive anchor text instead of generic "click here" links.
  • Validate structured data with Google's Rich Results Test. Incorrect schema can result in manual actions. Always match schema fields to visible on-page content.
  • Monitor changes in Search Console weekly. Track impressions, clicks, average position, and coverage errors after deploying SEO fixes to measure impact.

Edge Cases

  • Single-page applications (SPAs): JavaScript-rendered content may not be crawled. Implement server-side rendering (SSR) or dynamic rendering, and use the URL Inspection tool to verify Google sees the full DOM.
  • Multilingual sites: Each language version needs its own unique title, meta description, and hreflang annotations. Incorrect hreflang mappings can cause the wrong language to appear in SERPs.
  • Paywalled or gated content: Use <meta name="robots" content="noindex"> on pages that require login to avoid thin-content penalties, or implement structured data for paywalled content per Google's guidelines.
  • Pagination: Use rel="next" and rel="prev" on paginated archives, and ensure the canonical points to the current page rather than page 1.
  • Rapidly changing content: For news or e-commerce sites with frequent inventory changes, configure sitemap update frequency and use the Indexing API for time-sensitive pages.

© seb1n, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in marketing-and-seo/seo-optimization of seb1n/awesome-ai-agent-skills.

Open the folder on GitHubat commit 75865a5

Compare with similar skills

SEO Optimization next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

SEO Optimization compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Optimization this skillseb1n/awesome-ai-agent-skills206—~1.9kAutomated safety check: PassMIT
SEO Optimizerailabs-393/ai-labs-claude-skills4541 repos~3.2kAutomated safety check: PassMIT
SEOever-works/ever-works15810 repos~2.9kAutomated safety check: PassMIT
Universal SEO AnalysisAgriciDaniel/claude-seo18k—~4.9kAutomated safety check: PassMIT
Google Search SEO Guidelittleben/awesomeAgentskills1882 repos~4.2kAutomated safety check: PassMIT
Schema Markup Generatornowork-studio/notfair-plugin3.9k—~2.8kAutomated safety check: PassMIT

Similar skills

  • SEO Optimizer

    ailabs-393/ai-labs-claude-skills

    This skill should be used when analyzing HTML/CSS websites for SEO optimization, fixing SEO issues, generating SEO reports, or implementing SEO best practices.

    454 GitHub starsUsed in 1 repo~3.2k tokens
    Marketing & SEOAuto-check passed
  • SEO

    ever-works/ever-works

    Optimize for search engine visibility and ranking. An agent skill from ever-works/ever-works.

    158 GitHub starsUsed in 10 repos~2.9k tokens
    Marketing & SEOAuto-check passed
  • Universal SEO Analysis

    AgriciDaniel/claude-seo

    Hub for site-wide SEO work: audits, technical checks, schema, content quality, local, hreflang and AI-search readiness, run through slash commands.

    18k GitHub stars~4.9k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Google Search SEO Guide

    littleben/awesomeAgentskills

    Answers Google Search optimization questions from reference files covering crawling, indexing, structured data, Search Console and site visibility, drawn from Google's documentation.

    188 GitHub starsUsed in 2 repos~4.2k tokens
    Marketing & SEOAuto-check passed
  • Schema Markup Generator

    nowork-studio/notfair-plugin

    Creates JSON-LD structured data for FAQ, HowTo, Article, Product, LocalBusiness and nested schemas, mapping your content to properties and checking Google's requirements.

    3.9k GitHub stars~2.8k tokensUpdated 6 days ago
    Marketing & SEOAuto-check passed
  • Persian SEO

    TronIsHere/vibefarsiui

    Technical and on-page SEO for Persian (Farsi) websites: lang and hreflang for fa-IR, RTL-safe metadata, Persian titles and descriptions, slug and URL strategy for Persian content, ZWNJ and keyword…

    207 GitHub stars~1.7k tokensUpdated 7 days ago
    Marketing & SEOAuto-check: warnings

More from seb1n/awesome-ai-agent-skills

All 92 skills in this repo
  • Agent Red Teaming

    seb1n/awesome-ai-agent-skills

    Plan, execute, document, and retest authorized security assessments of AI agents and multi-agent workflows using safe adversarial cases, synthetic identities, canaries, and evidence-based findings.

    206 GitHub stars~2.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Eu AI Act Readiness

    seb1n/awesome-ai-agent-skills

    Build a preliminary, evidence-based EU AI Act readiness assessment across AI-system inventory, territorial scope, operator roles, prohibited-practice screening, risk classification, transparency…

    206 GitHub stars~3.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Human In The Loop

    seb1n/awesome-ai-agent-skills

    Design and verify auditable human oversight, approval gates, escalation paths, and safe state transitions for AI agent workflows.

    206 GitHub stars~2.5k tokensUpdated 1 mo ago
    Auto-check passed
  • MCP Server Building

    seb1n/awesome-ai-agent-skills

    Design, implement, harden, and verify Model Context Protocol (MCP) servers with precise tool contracts, least-privilege authorization, safe transports, structured errors, and interoperability tests.

    206 GitHub stars~2.5k tokensUpdated 1 mo ago
    Auto-check passed
  • PDF Processing

    seb1n/awesome-ai-agent-skills

    Inspect, extract, OCR, create, merge, split, reorder, rotate, annotate, fill, redact, compress, secure, and verify PDF documents while preserving source files and visual fidelity.

    206 GitHub stars~2.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Skill Supply Chain Audit

    seb1n/awesome-ai-agent-skills

    Audit agent skills, plugins, prompts, manifests, scripts, dependencies, and bundled assets for provenance, prompt-injection, permission, execution, exfiltration, persistence, and update risk.

    206 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about SEO Optimization

What does SEO Optimization do?

Optimize a webpage for search engines by analyzing on-page elements, improving technical performance, and implementing structured data for maximum visibility. SEO Optimization is an agent skill from seb1n/awesome-ai-agent-skills. Optimize a webpage for search engines by analyzing on-page elements, improving technical performance, and implementing structured data for maximum visibility.

When should I use SEO Optimization?

SEO Optimization fits situations like: the user requests seo optimization; provides relevant inputs for this workflow.

How do I install SEO Optimization in Claude Code?

Run `npx skills add seb1n/awesome-ai-agent-skills --skill seo-optimization -a claude-code`. Or copy the skill folder (marketing-and-seo/seo-optimization in seb1n/awesome-ai-agent-skills) into .claude/skills/seo-optimization in your project. Claude Code loads it when a task matches its description.

How do I install SEO Optimization in Codex?

Run `npx skills add seb1n/awesome-ai-agent-skills --skill seo-optimization -a codex`. Or copy the skill folder (marketing-and-seo/seo-optimization in seb1n/awesome-ai-agent-skills) into .agents/skills/seo-optimization in your project. Codex loads it when a task matches its description.

Can I use SEO Optimization in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add seb1n/awesome-ai-agent-skills --skill seo-optimization -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/seo-optimization, .gemini/skills/seo-optimization, .github/skills/seo-optimization and .opencode/skills/seo-optimization in your project.

What does SEO Optimization need to run?

SKILL.md names no scripts, command-line tools or credentials: SEO Optimization is instructions for the agent only.

Does SEO Optimization access the network?

SKILL.md names 2 domains. In commands or code: acme.com and schema.org; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is SEO Optimization safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does SEO Optimization use?

SEO Optimization is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does SEO Optimization use?

About 1.9k tokens (SKILL.md is roughly 7.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to SEO Optimization?

Skills that share tags, products or a category with SEO Optimization: SEO Optimizer (ailabs-393/ai-labs-claude-skills, 454 stars), SEO (ever-works/ever-works, 158 stars), Universal SEO Analysis (AgriciDaniel/claude-seo, 18k stars) and Google Search SEO Guide (littleben/awesomeAgentskills, 188 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Optimization?

seb1n (a GitHub user) maintains it in seb1n/awesome-ai-agent-skills, which has 206 GitHub stars. The repository holds 92 skills in this directory. The repository was last updated on August 9, 2026.

Source: seb1n/awesome-ai-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.