Agent skill

SEO

by affaan-m in affaan-m/ECC

Audit, plan, and implement SEO improvements across technical SEO, on-page optimization, structured data, Core Web Vitals, and content strategy.

MITAuto-check passedMarketing & SEO

Install SEO

skills CLI
$ npx skills add affaan-m/ECC --skill seo -a claude-code

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

GitHub CLI
$ gh skill install affaan-m/ECC 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/affaan-m/ECC.git skills-src && mkdir -p .claude/skills && cp -r skills-src/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
277k
Used in
2 other repos
Token cost
~1.1k tokens
SKILL.md length
429 words
Files
1
Skills in repo
683
Repo updated
First seen
Licence
MIT

At a glance

Audit, plan, and implement SEO improvements across technical SEO, on-page optimization, structured data, Core Web Vitals, and content strategy.

  • Works in 5 steps: Fix technical blockers before content… → One page should have one clear primary… → Prefer long-term quality signals over… → …
  • The user wants better search visibility
  • SKILL.md covers When to Use, How It Works, Examples and Anti-Patterns, plus 1 more section
  • Reaches schema.org

What it does

SEO is an agent skill from affaan-m/ECC. Audit, plan, and implement SEO improvements across technical SEO, on-page optimization, structured data, Core Web Vitals, and content strategy. Use when the user wants better search visibility, SEO remediation, schema markup, sitemap/robots work, or keyword mapping.

Its SKILL.md is about 1.1k 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 Technical SEO, Schema markup and On-page SEO. The repository describes itself as: The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond. The licence is MIT.

When your agent uses it

  • The user wants better search visibility
  • SEO remediation
  • Sitemap/robots work
  • Keyword mapping

Example prompts

  • “/seo”

Workflow steps

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

  1. Fix technical blockers before content optimization.
  2. One page should have one clear primary search intent.
  3. Prefer long-term quality signals over manipulative patterns.
  4. Mobile-first assumptions matter because indexing is mobile-first.
  5. Recommendations should be page-specific and implementable.

What it can do on your machine

Read from SKILL.md and the folder at commit 2d515e4. 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 json).

    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

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

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

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 affaan-m/ECC at commit 2d515e4, republished under its MIT licence (© affaan-m). 429 words, ~1,079 tokens.

Download SKILL.mdSave it as .claude/skills/seo/SKILL.md (or your agent's skills folder).
name
seo
description
Audit, plan, and implement SEO improvements across technical SEO, on-page optimization, structured data, Core Web Vitals, and content strategy. Use when the user wants better search visibility, SEO remediation, schema markup, sitemap/robots work, or keyword mapping.
metadata.origin
ECC

SEO

Improve search visibility through technical correctness, performance, and content relevance, not gimmicks.

When to Use

Use this skill when:

  • auditing crawlability, indexability, canonicals, or redirects
  • improving title tags, meta descriptions, and heading structure
  • adding or validating structured data
  • improving Core Web Vitals
  • doing keyword research and mapping keywords to URLs
  • planning internal linking or sitemap / robots changes

How It Works

Principles
  1. Fix technical blockers before content optimization.
  2. One page should have one clear primary search intent.
  3. Prefer long-term quality signals over manipulative patterns.
  4. Mobile-first assumptions matter because indexing is mobile-first.
  5. Recommendations should be page-specific and implementable.
Technical SEO checklist
Crawlability
  • robots.txt should allow important pages and block low-value surfaces
  • no important page should be unintentionally noindex
  • important pages should be reachable within a shallow click depth
  • avoid redirect chains longer than two hops
  • canonical tags should be self-consistent and non-looping
Indexability
  • preferred URL format should be consistent
  • multilingual pages need correct hreflang if used
  • sitemaps should reflect the intended public surface
  • no duplicate URLs should compete without canonical control
Performance
  • LCP < 2.5s
  • INP < 200ms
  • CLS < 0.1
  • common fixes: preload hero assets, reduce render-blocking work, reserve layout space, trim heavy JS
Structured data
  • homepage: organization or business schema where appropriate
  • editorial pages: Article / BlogPosting
  • product pages: Product and Offer
  • interior pages: BreadcrumbList
  • Q&A sections: FAQPage only when the content truly matches
On-page rules
Title tags
  • aim for roughly 50-60 characters
  • put the primary keyword or concept near the front
  • make the title legible to humans, not stuffed for bots
Show full SKILL.md (175 more words)Show less
Meta descriptions
  • aim for roughly 120-160 characters
  • describe the page honestly
  • include the main topic naturally
Heading structure
  • one clear H1
  • H2 and H3 should reflect actual content hierarchy
  • do not skip structure just for visual styling
Keyword mapping
  1. define the search intent
  2. gather realistic keyword variants
  3. prioritize by intent match, likely value, and competition
  4. map one primary keyword/theme to one URL
  5. detect and avoid cannibalization
Internal linking
  • link from strong pages to pages you want to rank
  • use descriptive anchor text
  • avoid generic anchors when a more specific one is possible
  • backfill links from new pages to relevant existing ones

Examples

Title formula
text
Primary Topic - Specific Modifier | Brand
Meta description formula
text
Action + topic + value proposition + one supporting detail
JSON-LD example
json
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Page Title Here",
  "author": {
    "@type": "Person",
    "name": "Author Name"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Brand Name"
  }
}
Audit output shape
text
[HIGH] Duplicate title tags on product pages
Location: src/routes/products/[slug].tsx
Issue: Dynamic titles collapse to the same default string, which weakens relevance and creates duplicate signals.
Fix: Generate a unique title per product using the product name and primary category.

Anti-Patterns

Anti-patternFix
keyword stuffingwrite for users first
thin near-duplicate pagesconsolidate or differentiate them
schema for content that is not actually presentmatch schema to reality
content advice without checking the actual pageread the real page first
generic “improve SEO” outputstie every recommendation to a page or asset
  • seo-specialist
  • frontend-patterns
  • brand-voice
  • market-research

© affaan-m, 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 skills/seo of affaan-m/ECC.

Open the folder on GitHubat commit 2d515e4

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in affaan-m/ECC, 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 skillaffaan-m/ECC277k2 repos~1.1kAutomated safety check: PassMIT
SEO Optimizeraiskillstore/marketplace4331 repos~2.9kAutomated safety check: PassNone
SEO Geoericrisco/rsc-harness180—~2.8kAutomated safety check: PassMIT
SEO Auditunifapi-agent/agents589—~3.4kAutomated safety check: PassMIT
Persian SEOTronIsHere/vibefarsiui212—~1.7kAutomated safety check: WarnMIT
Site Architecturealirezarezvani/claude-skills28k1 repos~3.5kAutomated safety check: PassMIT

Similar skills

  • SEO Optimizer

    aiskillstore/marketplace

    Search Engine Optimization specialist for content strategy, technical SEO, keyword research, and ranking improvements.

    433 GitHub starsUsed in 1 repo~2.9k tokens
    Marketing & SEOAuto-check passed
  • SEO Geo

    ericrisco/rsc-harness

    A skill your agent uses when one existing page needs to rank in Google AND get cited by AI answer engines — auditing a URL for on-page SEO, structured-data JSON-LD, GEO citation levers, Core Web…

    180 GitHub stars~2.8k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • SEO Audit

    unifapi-agent/agents

    When the user wants to audit, review, or diagnose SEO issues on their site.

    589 GitHub stars~3.4k tokensUpdated 1 mo 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…

    212 GitHub stars~1.7k tokensUpdated yesterday
    Marketing & SEOAuto-check: warnings
  • Site Architecture

    alirezarezvani/claude-skills

    When the user wants to audit, redesign, or plan their website's structure, URL hierarchy, navigation design, or internal linking strategy.

    28k GitHub starsUsed in 1 repo~3.5k tokens
    Marketing & SEOAuto-check passed
  • SEO Validate

    softspark/ai-toolkit

    SEO validator: meta/OG, Schema.org, hreflang, Core Web Vitals, crawlability.

    179 GitHub stars~3.9k tokensUpdated 3 days ago
    Marketing & SEOAuto-check: notes

More from affaan-m/ECC

All 682 skills in this repo
  • Skill Stocktake

    affaan-m/ECC

    Audits your installed Claude skills and commands for quality, with a quick mode for recently changed skills and a full mode that evaluates all of them through subagents.

    277k GitHub starsUsed in 5 repos~3.1k tokens
    Auto-check passed
  • Ingests, indexes, searches, edits and monitors video, audio and live streams through the VideoDB Python SDK, returning stream links, clips and timestamps.

    277k GitHub starsUsed in 3 repos~3.5k tokens
    Auto-check: notes
  • Docs Governance

    affaan-m/ECC

    Route broad documentation-governance requests to existing ECC skills and run an opt-in, read-only audit of mapped documentation roles, links, ADR indexes, and evidence references.

    277k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Rules Distillation

    affaan-m/ECC

    Scans installed skills for principles that recur across them and proposes rule-file changes: append, revise, add a section, create a file or leave as covered.

    277k GitHub starsUsed in 2 repos~2.3k tokens
    Auto-check passed
  • Builds DRAFT counterparty agreements from one markdown template and a small JSON spec per party, with clauses picked by the party's role.

    277k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Set an ECC-specific frontend design direction for production UI work.

    277k GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed

Categories

Questions about SEO

What does SEO do?

Audit, plan, and implement SEO improvements across technical SEO, on-page optimization, structured data, Core Web Vitals, and content strategy. SEO is an agent skill from affaan-m/ECC. Audit, plan, and implement SEO improvements across technical SEO, on-page optimization, structured data, Core Web Vitals, and content strategy.

When should I use SEO?

SEO fits situations like: the user wants better search visibility; SEO remediation; sitemap/robots work; keyword mapping.

How do I install SEO in Claude Code?

Run `npx skills add affaan-m/ECC --skill seo -a claude-code`. Or copy the skill folder (skills/seo in affaan-m/ECC) 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 affaan-m/ECC --skill seo -a codex`. Or copy the skill folder (skills/seo in affaan-m/ECC) 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 affaan-m/ECC --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 1 domain. In commands or code: schema.org; the agent is likely to contact it when it follows the instructions. 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 (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does SEO use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 (aiskillstore/marketplace, 433 stars), SEO Geo (ericrisco/rsc-harness, 180 stars), SEO Audit (unifapi-agent/agents, 589 stars) and Persian SEO (TronIsHere/vibefarsiui, 212 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO?

affaan-m (a GitHub user) maintains it in affaan-m/ECC, which has 276,673 GitHub stars. The repository holds 683 skills in this directory. The repository was last updated on October 11, 2026.

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