Agent skill

SEO Specialist

by borghei in borghei/Claude-Skills

SEO covering technical SEO, content optimization, link building, keyword research, and search analytics.

MITAuto-check passedMarketing & SEO

Install SEO Specialist

skills CLI
$ npx skills add borghei/Claude-Skills --skill seo-specialist -a claude-code

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

GitHub CLI
$ gh skill install borghei/Claude-Skills seo-specialist --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/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/marketing/seo-specialist .claude/skills/seo-specialist && 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-specialist
GitHub stars
886
Token cost
~2.8k tokens
SKILL.md length
1,090 words
Files
4 (incl. scripts)
Skills in repo
354
Repo updated
First seen
Licence
MIT

At a glance

SEO covering technical SEO, content optimization, link building, keyword research, and search analytics.

  • Works in 5 steps: Run technical audit - Check crawlability… → Research keywords - Start with seed… → Optimize on-page elements - Apply title… → …
  • Auditing technical SEO
  • SKILL.md covers Clarify First, Workflow, Technical SEO Audit Checklist and Keyword Research Process, plus 9 more sections
  • Runs Python scripts from its folder; calls python; reaches schema.org

What it does

SEO Specialist is an agent skill from borghei/Claude-Skills. SEO covering technical SEO, content optimization, link building, keyword research, and search analytics. Use when auditing technical SEO, researching keywords, optimizing on-page elements, or analyzing organic search performance.

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `scripts/content_scorer.py`, `scripts/keyword_analyzer.py` and `scripts/serp_simulator.py`).

It sits in Marketing & SEO, covering Technical SEO, Keyword research and On-page SEO. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.

When your agent uses it

  • Auditing technical SEO
  • Researching keywords
  • Optimizing on-page elements
  • Analyzing organic search performance

Example prompts

  • “/seo-specialist”

Requirements

  • Python 3

Workflow steps

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

  1. Run technical audit - Check crawlability (robots.txt, sitemap, canonical tags), indexability (duplicate content, thin pages), performance…
  2. Research keywords - Start with seed keywords, expand via competitor analysis and search suggest, analyze by volume/difficulty/intent, and…
  3. Optimize on-page elements - Apply title tag, meta description, heading hierarchy, keyword placement, image alt text, and schema markup…
  4. Build link acquisition plan - Identify content-based (original research, guides), outreach-based (guest posts, HARO), and…
  5. Monitor and report - Track organic traffic, keyword rankings, Core Web Vitals, and conversion rate. Review weekly; report monthly…

What it can do on your machine

Read from SKILL.md and the folder at commit 4a698e8. 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

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    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 Specialist loads about 2.8k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 1,090 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from borghei/Claude-Skills at commit 4a698e8, republished under its MIT licence (© borghei). 1,090 words, ~2,819 tokens.

Download SKILL.mdSave it as .claude/skills/seo-specialist/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
seo-specialist
description
SEO covering technical SEO, content optimization, link building, keyword research, and search analytics. Use when auditing technical SEO, researching keywords, optimizing on-page elements, or analyzing organic search performance.
license
MIT + Commons Clause
metadata.version
1.0.0
metadata.author
borghei
metadata.category
marketing-growth
metadata.updated
2026-03-31
metadata.tags
seo, search, keywords, technical-seo, link-building

SEO Specialist

The agent operates as a senior SEO specialist, delivering technical audits, keyword strategies, on-page optimization, link building plans, and performance analysis for organic search growth.

Clarify First

Before starting, confirm these inputs. If any is unknown or vague, ASK — do not assume:

  • Deliverable — technical audit, keyword research, on-page optimization, link plan, or performance report — selects which workflow runs
  • Domain & seed topics/keywords — the site and the terms you want to rank for — drives keyword research and prioritization
  • Business goal — the conversion or revenue outcome behind ranking — sets prioritization by business value × ranking opportunity

Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.

Workflow

  1. Run technical audit - Check crawlability (robots.txt, sitemap, canonical tags), indexability (duplicate content, thin pages), performance (Core Web Vitals), and structure (URL hierarchy, internal linking). Checkpoint: zero critical crawl errors in Search Console.
  2. Research keywords - Start with seed keywords, expand via competitor analysis and search suggest, analyze by volume/difficulty/intent, and prioritize by business value and ranking opportunity. Checkpoint: each target keyword has a mapped content asset.
  3. Optimize on-page elements - Apply title tag, meta description, heading hierarchy, keyword placement, image alt text, and schema markup. Checkpoint: primary keyword appears in H1, first 100 words, and title tag.
  4. Build link acquisition plan - Identify content-based (original research, guides), outreach-based (guest posts, HARO), and relationship-based (partners, testimonials) opportunities. Checkpoint: target links have DA 50+ and topical relevance.
  5. Monitor and report - Track organic traffic, keyword rankings, Core Web Vitals, and conversion rate. Review weekly; report monthly. Checkpoint: dashboard covers visibility, engagement, and conversions.

Technical SEO Audit Checklist

Crawlability:

  • Robots.txt properly configured
  • XML sitemap submitted and current
  • No critical crawl errors in Search Console
  • Canonical tags on all indexable pages
  • Noindex/nofollow used correctly

Performance (Core Web Vitals):

MetricGoodNeeds ImprovementPoor
LCP (Largest Contentful Paint)< 2.5s2.5s - 4s> 4s
INP (Interaction to Next Paint)≤ 200ms200 - 500ms> 500ms
CLS (Cumulative Layout Shift)< 0.10.1 - 0.25> 0.25

Structure:

  • Clean, descriptive URL slugs
  • Proper heading hierarchy (single H1, logical H2/H3)
  • Internal linking between related content
  • Breadcrumbs implemented

Keyword Research Process

  1. Seed - Brainstorm topics, analyze competitors, mine customer interviews
  2. Expand - Use Ahrefs/SEMrush, Google Suggest, People Also Ask, related searches
  3. Analyze - Score by search volume, keyword difficulty, search intent, SERP features
  4. Prioritize - Rank by business value x ranking opportunity
Keyword Metrics Guide
MetricGoodModerateDifficult
Volume1000+100-1000< 100
Difficulty< 3030-60> 60
CPC (commercial signal)> $5$1-5< $1
Search Intent Classification
IntentSignal WordsContent Type
Informational"how to", "what is", "guide"Blog posts, tutorials
NavigationalBrand names, product namesHomepage, product pages
Commercial"best", "reviews", "vs"Comparison pages, reviews
Transactional"buy", "discount", "pricing"Product pages, landing pages

On-Page Optimization Checklist

Title Tag: primary keyword front-loaded, 50-60 characters, compelling for CTR Meta Description: includes keyword, clear value prop, CTA, 150-160 characters Headings: H1 contains primary keyword, H2s contain secondary keywords, logical hierarchy Content: keyword in first 100 words, natural density, related terms (LSI), comprehensive coverage Images: descriptive filenames, keyword-rich alt text, compressed, lazy-loaded

Example: Optimized Page Structure

html
<!-- Title: 58 chars, keyword front-loaded -->
<title>Cloud Cost Optimization: 7 Strategies That Cut AWS Bills 40%</title>

<!-- Meta: 155 chars, keyword + value prop + CTA -->
<meta name="description" content="Learn 7 proven cloud cost optimization
strategies used by 500+ engineering teams. Reduce AWS spend by 40% without
sacrificing performance. Free checklist inside.">

<!-- Schema markup for article -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Cloud Cost Optimization: 7 Strategies That Cut AWS Bills 40%",
  "author": {"@type": "Person", "name": "Jane Chen"},
  "datePublished": "2026-02-15",
  "publisher": {
    "@type": "Organization",
    "name": "CloudOps Weekly"
  }
}
</script>

<h1>Cloud Cost Optimization: 7 Strategies That Cut AWS Bills 40%</h1>
<p>Cloud cost optimization is the #1 priority for engineering leaders in 2026...</p>

<h2>1. Right-Size EC2 Instances Using Usage Data</h2>
<h3>How to Identify Oversized Instances</h3>

<h2>FAQ</h2>
<h3>What is cloud cost optimization?</h3>
<h3>How much can cloud optimization save?</h3>
FactorHigh QualityLow Quality
Domain Authority50+< 20
RelevanceSame industryUnrelated
TrafficActive siteDead site
Link TypeEditorialPaid/Spam
Anchor TextNatural variationExact match spam

SEO Performance Dashboard

SEO Performance - March 2026
  Organic Traffic: 125,432 (+12% MoM)
  Rankings: Top 3: 45 | Top 10: 234
  Conversions: 542 (+15% MoM)

  Top Growing Keywords
  1. "cloud cost optimization" - #8 -> #3 (+5)
  2. "aws billing alerts"     - #15 -> #7 (+8)
  3. "kubernetes autoscaling"  - New -> #12

  Technical Health
  Core Web Vitals: Pass | Index: 1,234 pages | Crawl Errors: 3

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

Troubleshooting

ProblemLikely CauseFix
Rankings dropped after Google core updateE-E-A-T signals insufficient or content quality below new thresholdsAudit content against December 2025 / March 2026 core update criteria — add experience signals, author credentials, original data
High impressions but low CTRTitle tags and meta descriptions not compelling enough for the SERPRewrite titles with numbers, power words, and clear value props; test meta descriptions with hooks
FID replaced by INP — pages now failing CWVINP measures all interactions, not just first — JS-heavy pages failBreak long JS tasks, defer third-party scripts, audit event handlers. INP replaced FID as a Core Web Vital on March 12, 2024 ("good" = 200 ms or less)
Indexed pages declining in Search ConsoleGoogle tightening quality bar — deindexing thin or duplicate contentConsolidate thin pages, add unique content, improve E-E-A-T signals on remaining pages
AI Overviews stealing clicks from position 1Google AI Overviews now appear in 50%+ of queries, reducing organic CTR by ~42%Optimize for AI citation (extractable content blocks), add FAQ schema, target queries less likely to trigger AI Overviews
Keyword cannibalization across blog and product pagesMultiple pages competing for same keyword with conflicting intentMap one primary keyword per page, consolidate or redirect competing pages, differentiate intent

Success Criteria

  • Organic traffic growth: 10%+ month-over-month organic traffic growth sustained over 6 months
  • Top 10 rankings: 50%+ of target keywords ranking in top 10 positions within 6 months
  • Core Web Vitals: All three metrics passing (LCP < 2.5s, INP < 200ms, CLS < 0.1) at 75th percentile — only 47-55% of sites achieve this in 2026
  • CTR performance: Position 1 achieving 25%+ CTR, position 3 achieving 10%+ CTR (2026 benchmarks)
  • Conversion from organic: Organic traffic converting at 2%+ for B2B, 2.5%+ for e-commerce (industry benchmarks)
  • Indexation health: 95%+ of target pages indexed with zero critical crawl errors
  • E-E-A-T compliance: Author bylines, credentials, and experience signals on 100% of content pages

Scope & Limitations

In scope:

  • Technical SEO auditing (crawlability, indexation, Core Web Vitals, site structure)
  • Keyword research, intent classification, and prioritization
  • On-page optimization (title tags, meta descriptions, headings, content, schema)
  • Link building strategy and opportunity identification
  • Organic search performance monitoring and reporting
  • Algorithm update impact assessment and recovery planning

Out of scope:

  • Paid search / Google Ads management
  • Social media marketing and optimization
  • Content writing and production (use Content Production skill)
  • AI-specific search optimization (use AI SEO skill)
  • Website development or code deployment
  • Brand strategy and positioning

Known limitations:

  • Keyword difficulty scores vary significantly across tools — no single source of truth
  • Google algorithm changes 500-600 times per year; strategies require continuous adaptation
  • AI Overviews are reducing organic CTR — position 1 no longer guarantees high click volume
  • Backlink analysis requires third-party tools (Ahrefs, SEMrush, Moz) for comprehensive data
  • INP optimization often requires developer involvement for JavaScript refactoring

Integration Points

  • SEO Audit — Use for comprehensive 85-point site audits when detailed diagnostic is needed.
  • AI SEO — Use alongside traditional SEO for AI search citation optimization.
  • Schema Markup — Use for structured data implementation after on-page optimization.
  • Site Architecture — Use when structural issues (deep nesting, orphan pages) block ranking progress.
  • Content Strategy — Use for topic selection and editorial calendar planning before SEO optimization.
  • Content Humanizer — Use when content flagged as AI-generated needs authenticity improvement.

Scripts

bash
# Analyze keyword list for search intent and difficulty
python scripts/keyword_analyzer.py --keywords keywords.csv --json

# Simulate SERP appearance for a page
python scripts/serp_simulator.py --title "Cloud Cost Optimization Guide" --description "Learn 7 proven strategies..." --url "/guides/cloud-cost" --json

# Score content for on-page SEO quality
python scripts/content_scorer.py article.md --keyword "cloud cost optimization" --json

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

Files

SKILL.md and 3 other files (scripts) in marketing/seo-specialist of borghei/Claude-Skills.

  • SKILL.md
  • scripts/content_scorer.py
  • scripts/keyword_analyzer.py
  • scripts/serp_simulator.py

Open the folder on GitHubat commit 4a698e8

Compare with similar skills

SEO Specialist 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 Specialist compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Specialist this skillborghei/Claude-Skills886—~2.8kAutomated safety check: PassMIT
E2E SEO Assistantirinabuht12-oss/marketing-skills4k—~1.9kAutomated safety check: PassNone
Content SEOjdevalk/skills105—~2.3kAutomated safety check: PassMIT
SEO Auditunifapi-agent/agents589—~3.4kAutomated safety check: PassMIT
Site Structure Optimizeraaron-he-zhu/aaron-marketing-skills2.9k1 repos~3.9kAutomated safety check: PassApache-2.0
Business Website Setupsickn33/agentic-awesome-skills47k1 repos~6.2kAutomated safety check: PassMIT

Similar skills

  • E2E SEO Assistant

    irinabuht12-oss/marketing-skills

    Full SEO workflow covering technical audits, content gaps, backlink opportunities, on-page fixes, and content briefs.

    4k GitHub stars~1.9k tokensUpdated 16 days ago
    Marketing & SEOAuto-check passed
  • Content SEO

    jdevalk/skills

    Audits a blog post draft or page copy for content-level SEO: search intent fit, focus keyphrase placement, E-E-A-T signals (experience, expertise, authoritativeness, trustworthiness), helpfulness…

    105 GitHub stars~2.3k tokensUpdated 3 mo 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
  • Site Structure Optimizer

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "plan my site structure", "design the page hierarchy / navigation / URL taxonomy", "fix internal linking", or "find orphan pages"; runs two modes —…

    2.9k GitHub starsUsed in 1 repo~3.9k tokens
    Marketing & SEOAuto-check passed
  • Business Website Setup

    sickn33/agentic-awesome-skills

    Website page register: URL, title, meta description, search intent, NAP block, schema type, canonical, indexability and Core Web Vitals target.

    47k GitHub starsUsed in 1 repo~6.2k tokens
    Marketing & SEOAuto-check passed
  • Afa SEO

    afadtc/afa-dtc-skills

    DTC SEO 与有机搜索——技术SEO、关键词、内容规划、产品页、结构化数据、外链。触发词: SEO, 搜索引擎优化, 关键词, 有机流量, 技术SEO, 反向链接, 产品页SEO, 搜索排名, keyword research, backlinks, technical seo, site speed, search ranking。复杂问题先经 afa。

    168 GitHub stars~2.2k tokensUpdated yesterday
    Marketing & SEOAuto-check passed

More from borghei/Claude-Skills

All 354 skills in this repo
  • Agent Harness

    borghei/Claude-Skills

    Test and evaluation harness for AI agents — scenario suites, deterministic replay, regression diffing, cost and latency budgets.

    886 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Agents In The Team

    borghei/Claude-Skills

    Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.

    886 GitHub stars~4.2k tokensUpdated 2 days ago
    Auto-check passed
  • AI Content Disclosure

    borghei/Claude-Skills

    Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.

    886 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • AI Prototyping

    borghei/Claude-Skills

    Idea to AI-generated prototype to customer validation to engineering handoff.

    886 GitHub stars~3.6k tokensUpdated 2 days ago
    Auto-check passed
  • Analytics Engineer

    borghei/Claude-Skills

    Analytics engineering across data modeling, dbt, transformation, and semantic layers.

    886 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • Ansoff Matrix

    borghei/Claude-Skills

    Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.

    886 GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about SEO Specialist

What does SEO Specialist do?

SEO covering technical SEO, content optimization, link building, keyword research, and search analytics. SEO Specialist is an agent skill from borghei/Claude-Skills. SEO covering technical SEO, content optimization, link building, keyword research, and search analytics.

When should I use SEO Specialist?

SEO Specialist fits situations like: auditing technical SEO; researching keywords; optimizing on-page elements; analyzing organic search performance.

How do I install SEO Specialist in Claude Code?

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

How do I install SEO Specialist in Codex?

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

Can I use SEO Specialist 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 borghei/Claude-Skills --skill seo-specialist -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-specialist, .gemini/skills/seo-specialist, .github/skills/seo-specialist and .opencode/skills/seo-specialist in your project.

What does SEO Specialist need to run?

Going by SKILL.md and its folder, SEO Specialist needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does SEO Specialist 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 Specialist 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does SEO Specialist use?

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

About 2.8k tokens (SKILL.md is roughly 11k 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 Specialist?

Skills that share tags, products or a category with SEO Specialist: E2E SEO Assistant (irinabuht12-oss/marketing-skills, 4k stars), Content SEO (jdevalk/skills, 105 stars), SEO Audit (unifapi-agent/agents, 589 stars) and Site Structure Optimizer (aaron-he-zhu/aaron-marketing-skills, 2.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Specialist?

borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 886 GitHub stars. The repository holds 354 skills in this directory. The repository was last updated on October 7, 2026.

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