Agent skill

SEO

by ever-works in ever-works/ever-works

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

MITAuto-check passedMarketing & SEO

Install SEO

skills CLI
$ npx skills add ever-works/ever-works --skill seo -a claude-code

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

GitHub CLI
$ gh skill install ever-works/ever-works seo --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/ever-works/ever-works.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/seo .claude/skills/seo && 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
GitHub stars
158
Used in
10 other repos
Token cost
~2.9k tokens
SKILL.md length
409 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

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

  • Asked to improve SEO
  • SKILL.md covers SEO fundamentals, Technical SEO, On-page SEO and Structured data (JSON-LD), plus 3 more sections
  • Reaches schema.org and sitemaps.org
  • Optimize for search

What it does

SEO is an agent skill from ever-works/ever-works. Optimize for search engine visibility and ranking. Use when asked to "improve SEO", "optimize for search", "fix meta tags", "add structured data", "sitemap optimization", or "search engine optimization".

Its SKILL.md is about 2.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 On-page SEO, Schema markup and Technical SEO. The repository describes itself as: Ever® Works™ - The Workshop for AI. An open agentic runtime that autonomously researches, ships, and maintains entire businesses, 24/7 - https://ever.works. The licence is MIT.

When your agent uses it

  • Asked to improve SEO
  • Optimize for search
  • Add structured data
  • Sitemap optimization

Example prompts

  • “improve SEO”
  • “optimize for search”
  • “fix meta tags”
  • “/seo”

What it can do on your machine

Read from SKILL.md and the folder at commit 11d15aa. 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, css and xml).

    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:

    • schema.org
    • sitemaps.org
    • twitter.com
    • linkedin.com

    Also links to:

    • search.google.com
    • validator.schema.org
    • developers.google.com

    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 loads about 2.9k tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 409 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~2.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 ever-works/ever-works at commit 11d15aa, republished under its MIT licence (© ever-works). 409 words, ~2,931 tokens.

Download SKILL.mdSave it as .claude/skills/seo/SKILL.md (or your agent's skills folder).
name
seo
description
Optimize for search engine visibility and ranking. Use when asked to "improve SEO", "optimize for search", "fix meta tags", "add structured data", "sitemap optimization", or "search engine optimization".
license
MIT
metadata.author
web-quality-skills
metadata.version
1.0

SEO optimization

Search engine optimization based on Lighthouse SEO audits and Google Search guidelines. Focus on technical SEO, on-page optimization, and structured data.

SEO fundamentals

Search ranking factors (approximate influence):

FactorInfluenceThis Skill
Content quality & relevance~40%Partial (structure)
Backlinks & authority~25%✗
Technical SEO~15%✓
Page experience (Core Web Vitals)~10%See Core Web Vitals
On-page SEO~10%✓

Technical SEO

Crawlability

robots.txt:

text
# /robots.txt
User-agent: *
Allow: /

# Block admin/private areas
Disallow: /admin/
Disallow: /api/
Disallow: /private/

# Don't block resources needed for rendering
# ❌ Disallow: /static/

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

Meta robots:

html
<!-- Default: indexable, followable -->
<meta name="robots" content="index, follow" />

<!-- Noindex specific pages -->
<meta name="robots" content="noindex, nofollow" />

<!-- Indexable but don't follow links -->
<meta name="robots" content="index, nofollow" />

<!-- Control snippets -->
<meta name="robots" content="max-snippet:150, max-image-preview:large" />

Canonical URLs:

html
<!-- Prevent duplicate content issues -->
<link rel="canonical" href="https://example.com/page" />

<!-- Self-referencing canonical (recommended) -->
<link rel="canonical" href="https://example.com/current-page" />

<!-- For paginated content -->
<link rel="canonical" href="https://example.com/products" />
<!-- Or use rel="prev" / rel="next" for explicit pagination -->
XML sitemap
xml
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://example.com/</loc>
    <lastmod>2024-01-15</lastmod>
    <changefreq>daily</changefreq>
    <priority>1.0</priority>
  </url>
  <url>
    <loc>https://example.com/products</loc>
    <lastmod>2024-01-14</lastmod>
    <changefreq>weekly</changefreq>
    <priority>0.8</priority>
  </url>
</urlset>

Sitemap best practices:

  • Maximum 50,000 URLs or 50MB per sitemap
  • Use sitemap index for larger sites
  • Include only canonical, indexable URLs
  • Update lastmod when content changes
  • Submit to Google Search Console
URL structure
✅ Good URLs:
https://example.com/products/blue-widget
https://example.com/blog/how-to-use-widgets

❌ Poor URLs:
https://example.com/p?id=12345
https://example.com/products/item/category/subcategory/blue-widget-2024-sale-discount

URL guidelines:

  • Use hyphens, not underscores
  • Lowercase only
  • Keep short (< 75 characters)
  • Include target keywords naturally
  • Avoid parameters when possible
  • Use HTTPS always
HTTPS & security
html
<!-- Ensure all resources use HTTPS -->
<img src="https://example.com/image.jpg" />

<!-- Not: -->
<img src="http://example.com/image.jpg" />

Security headers for SEO trust signals:

Strict-Transport-Security: max-age=31536000; includeSubDomains
X-Content-Type-Options: nosniff
X-Frame-Options: DENY

On-page SEO

Title tags
html
<!-- ❌ Missing or generic -->
<title>Page</title>
<title>Home</title>

<!-- ✅ Descriptive with primary keyword -->
<title>Blue Widgets for Sale | Premium Quality | Example Store</title>

Title tag guidelines:

  • 50-60 characters (Google truncates ~60)
  • Primary keyword near the beginning
  • Unique for every page
  • Brand name at end (unless homepage)
  • Action-oriented when appropriate
Meta descriptions
html
<!-- ❌ Missing or duplicate -->
<meta name="description" content="" />

<!-- ✅ Compelling and unique -->
<meta
	name="description"
	content="Shop premium blue widgets with free shipping. 30-day returns. Rated 4.9/5 by 10,000+ customers. Order today and save 20%."
/>

Meta description guidelines:

  • 150-160 characters
  • Include primary keyword naturally
  • Compelling call-to-action
  • Unique for every page
  • Matches page content
Heading structure
html
<!-- ❌ Poor structure -->
<h2>Welcome to Our Store</h2>
<h4>Products</h4>
<h1>Contact Us</h1>

<!-- ✅ Proper hierarchy -->
<h1>Blue Widgets - Premium Quality</h1>
<h2>Product Features</h2>
<h3>Durability</h3>
<h3>Design</h3>
<h2>Customer Reviews</h2>
<h2>Pricing</h2>

Heading guidelines:

  • Single <h1> per page (the main topic)
  • Logical hierarchy (don't skip levels)
  • Include keywords naturally
  • Descriptive, not generic
Image SEO
html
<!-- ❌ Poor image SEO -->
<img src="IMG_12345.jpg" />

<!-- ✅ Optimized image -->
<img
	src="blue-widget-product-photo.webp"
	alt="Blue widget with chrome finish, side view showing control panel"
	width="800"
	height="600"
	loading="lazy"
/>

Image guidelines:

  • Descriptive filenames with keywords
  • Alt text describes the image content
  • Compressed and properly sized
  • WebP/AVIF with fallbacks
  • Lazy load below-fold images
Internal linking
html
<!-- ❌ Non-descriptive -->
<a href="/products">Click here</a>
<a href="/widgets">Read more</a>

<!-- ✅ Descriptive anchor text -->
<a href="/products/blue-widgets">Browse our blue widget collection</a>
<a href="/guides/widget-maintenance">Learn how to maintain your widgets</a>

Linking guidelines:

  • Descriptive anchor text with keywords
  • Link to relevant internal pages
  • Reasonable number of links per page
  • Fix broken links promptly
  • Use breadcrumbs for hierarchy

Show full SKILL.md (151 more words)Show less

Structured data (JSON-LD)

Organization
html
<script type="application/ld+json">
	{
		"@context": "https://schema.org",
		"@type": "Organization",
		"name": "Example Company",
		"url": "https://example.com",
		"logo": "https://example.com/logo.png",
		"sameAs": ["https://twitter.com/example", "https://linkedin.com/company/example"],
		"contactPoint": {
			"@type": "ContactPoint",
			"telephone": "+1-555-123-4567",
			"contactType": "customer service"
		}
	}
</script>
Article
html
<script type="application/ld+json">
	{
		"@context": "https://schema.org",
		"@type": "Article",
		"headline": "How to Choose the Right Widget",
		"description": "Complete guide to selecting widgets for your needs.",
		"image": "https://example.com/article-image.jpg",
		"author": {
			"@type": "Person",
			"name": "Jane Smith",
			"url": "https://example.com/authors/jane-smith"
		},
		"publisher": {
			"@type": "Organization",
			"name": "Example Blog",
			"logo": {
				"@type": "ImageObject",
				"url": "https://example.com/logo.png"
			}
		},
		"datePublished": "2024-01-15",
		"dateModified": "2024-01-20"
	}
</script>
Product
html
<script type="application/ld+json">
	{
		"@context": "https://schema.org",
		"@type": "Product",
		"name": "Blue Widget Pro",
		"image": "https://example.com/blue-widget.jpg",
		"description": "Premium blue widget with advanced features.",
		"brand": {
			"@type": "Brand",
			"name": "WidgetCo"
		},
		"offers": {
			"@type": "Offer",
			"price": "49.99",
			"priceCurrency": "USD",
			"availability": "https://schema.org/InStock",
			"url": "https://example.com/products/blue-widget"
		},
		"aggregateRating": {
			"@type": "AggregateRating",
			"ratingValue": "4.8",
			"reviewCount": "1250"
		}
	}
</script>
FAQ
html
<script type="application/ld+json">
	{
		"@context": "https://schema.org",
		"@type": "FAQPage",
		"mainEntity": [
			{
				"@type": "Question",
				"name": "What colors are available?",
				"acceptedAnswer": {
					"@type": "Answer",
					"text": "Our widgets come in blue, red, and green."
				}
			},
			{
				"@type": "Question",
				"name": "What is the warranty?",
				"acceptedAnswer": {
					"@type": "Answer",
					"text": "All widgets include a 2-year warranty."
				}
			}
		]
	}
</script>
Breadcrumbs
html
<script type="application/ld+json">
	{
		"@context": "https://schema.org",
		"@type": "BreadcrumbList",
		"itemListElement": [
			{
				"@type": "ListItem",
				"position": 1,
				"name": "Home",
				"item": "https://example.com"
			},
			{
				"@type": "ListItem",
				"position": 2,
				"name": "Products",
				"item": "https://example.com/products"
			},
			{
				"@type": "ListItem",
				"position": 3,
				"name": "Blue Widgets",
				"item": "https://example.com/products/blue-widgets"
			}
		]
	}
</script>
Validation

Test structured data at:


Mobile SEO

Responsive design
html
<!-- ❌ Not mobile-friendly -->
<meta name="viewport" content="width=1024" />

<!-- ✅ Responsive viewport -->
<meta name="viewport" content="width=device-width, initial-scale=1" />
Tap targets
css
/* ❌ Too small for mobile */
.small-link {
	padding: 4px;
	font-size: 12px;
}

/* ✅ Adequate tap target */
.mobile-friendly-link {
	padding: 12px;
	font-size: 16px;
	min-height: 48px;
	min-width: 48px;
}
Font sizes
css
/* ❌ Too small on mobile */
body {
	font-size: 10px;
}

/* ✅ Readable without zooming */
body {
	font-size: 16px;
	line-height: 1.5;
}

International SEO

Hreflang tags
html
<!-- For multi-language sites -->
<link rel="alternate" hreflang="en" href="https://example.com/page" />
<link rel="alternate" hreflang="es" href="https://example.com/es/page" />
<link rel="alternate" hreflang="fr" href="https://example.com/fr/page" />
<link rel="alternate" hreflang="x-default" href="https://example.com/page" />
Language declaration
html
<html lang="en">
	<!-- or -->
	<html lang="es-MX"></html>
</html>

SEO audit checklist

Critical
  • HTTPS enabled
  • robots.txt allows crawling
  • No noindex on important pages
  • Title tags present and unique
  • Single <h1> per page
High priority
  • Meta descriptions present
  • Sitemap submitted
  • Canonical URLs set
  • Mobile-responsive
  • Core Web Vitals passing
Medium priority
  • Structured data implemented
  • Internal linking strategy
  • Image alt text
  • Descriptive URLs
  • Breadcrumb navigation
Ongoing
  • Fix crawl errors in Search Console
  • Update sitemap when content changes
  • Monitor ranking changes
  • Check for broken links
  • Review Search Console insights

Tools

ToolUse
Google Search ConsoleMonitor indexing, fix issues
Google PageSpeed InsightsPerformance + Core Web Vitals
Rich Results TestValidate structured data
LighthouseFull SEO audit
Screaming FrogCrawl analysis

References

© ever-works, 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 .agents/skills/seo of ever-works/ever-works.

Open the folder on GitHubat commit 11d15aa

Used in 10 other repositories

We found 10 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 10 other GitHub owners. This page covers the copy in ever-works/ever-works, which our catalogue first saw on October 7, 2026.

Compare with similar skills

SEO 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO this skillever-works/ever-works15810 repos~2.9kAutomated safety check: PassMIT
SEO Optimizerailabs-393/ai-labs-claude-skills4541 repos~3.2kAutomated 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
Persian SEOTronIsHere/vibefarsiui208—~1.7kAutomated safety check: WarnNone

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
  • 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 4 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 8 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…

    208 GitHub stars~1.7k tokensUpdated 8 days ago
    Marketing & SEOAuto-check: warnings
  • Generative Engine Optimization

    tech-leads-club/agent-skills

    Makes a page or site easier for AI answer engines to find, understand, trust and quote, using metadata, structured data, an llms.txt file and clear page structure.

    7k GitHub stars~2.5k tokensUpdated 18 days ago
    Marketing & SEOAuto-check passed

More from ever-works/ever-works

All 14 skills in this repo
  • Nodejs Backend Patterns

    ever-works/ever-works

    Build production-ready Node.js backend services with Express/Fastify, implementing middleware patterns, error handling, authentication, database integration, and API design best practices.

    158 GitHub starsUsed in 18 repos~4k tokens
    Auto-check passed
  • Accessibility

    ever-works/ever-works

    Audit and improve web accessibility following WCAG 2.2 guidelines.

    158 GitHub starsUsed in 6 repos~3.2k tokens
    Auto-check passed
  • Tailwind CSS Patterns

    ever-works/ever-works

    Provides comprehensive Tailwind CSS utility-first styling patterns including responsive design, layout utilities, flexbox, grid, spacing, typography, colors, and modern CSS best practices.

    158 GitHub starsUsed in 3 repos~1.6k tokens
    Auto-check: notes
  • Nodejs Express Server

    ever-works/ever-works

    Build production-ready Express.js servers with middleware, authentication, routing, and database integration.

    158 GitHub stars~965 tokensUpdated 3 days ago
    Auto-check passed
  • Tailwind V4 Shadcn

    ever-works/ever-works

    Production-tested setup for Tailwind CSS v4 with shadcn/ui, Vite, and React.

    158 GitHub starsUsed in 2 repos~3.8k tokens
    Auto-check passed
  • Configure email verification, implement password reset flows, set password policies, and customise hashing algorithms for Better Auth email/password authentication.

    158 GitHub starsUsed in 3 repos~1.5k tokens
    Auto-check passed

Categories

Questions about SEO

What does SEO do?

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

When should I use SEO?

SEO fits situations like: asked to improve SEO; optimize for search; add structured data; sitemap optimization.

How do I install SEO in Claude Code?

Run `npx skills add ever-works/ever-works --skill seo -a claude-code`. Or copy the skill folder (.agents/skills/seo in ever-works/ever-works) into .claude/skills/seo in your project. Claude Code loads it when a task matches its description.

How do I install SEO in Codex?

Run `npx skills add ever-works/ever-works --skill seo -a codex`. Or copy the skill folder (.agents/skills/seo in ever-works/ever-works) into .agents/skills/seo in your project. Codex loads it when a task matches its description.

Can I use SEO 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 ever-works/ever-works --skill seo -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, .gemini/skills/seo, .github/skills/seo and .opencode/skills/seo in your project.

What does SEO need to run?

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

Does SEO access the network?

SKILL.md names 7 domains. In commands or code: schema.org, sitemaps.org, twitter.com and linkedin.com; the agent is likely to contact these when it follows the instructions. As links in the text: search.google.com, validator.schema.org and developers.google.com. This is read from the text; nothing was executed.

Is SEO 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 use?

SEO 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 use?

About 2.9k tokens (SKILL.md is roughly 12k 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?

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

Who maintains SEO?

ever-works (a GitHub organization) maintains it in ever-works/ever-works, which has 158 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 5, 2026.

Source: ever-works/ever-works on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.