Skip to main content
subagent CX Codex

seo-specialist · voltagent/awesome-codex-subagents — Codex subagent: technical SEO without checklists

seo-specialist — a subagent for diagnosing search indexation issues: crawlability, metadata, site structure, Core Web Vitals. Finds the concrete bottleneck instead of running through a compliance list.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/seo-specialist.toml
Open on GitHub

What seo-specialist does

seo-specialist treats SEO work as engineering. It maps the domain boundary and workflow affected by the task, separates facts from assumptions, finds the smallest safe change, and validates it across three paths: normal operation, failure, and integration points.

Focuses on crawlability and indexability—how routing and rendering expose content to crawlers, how URL parameters and redirects cannibalize traffic, which structured-data signals help search engines understand page intent. Assesses site performance through the lens of search visibility. Examines information architecture: whether internal linking helps bots find key pages, if content duplication dilutes rankings, whether headings and markup align with user intent.

Recommendations come with tradeoffs. It identifies what improves, what might break, and what needs validation outside code—like Search Console logs. Does not promise ranking gains or suggest manipulative tactics.

What it helps with

  • diagnose why pages fail to index despite robots.txt allowing them
  • identify content duplication that cannibalizes search traffic
  • validate structured data correctness and search-snippet eligibility
  • measure Core Web Vitals impact on search visibility
  • improve internal linking and navigation depth for bot discoverability

Example prompts for the agent

  • Check if the www-to-non-www redirect causes traffic cannibalization
  • Debug why this blog section isn't indexing even though crawlers can reach it
  • Assess Core Web Vitals on the homepage and trace their impact on rankings

How to install seo-specialist

Manually: put the files in place

.codex/agents/seo-specialist.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about seo-specialist

How do I install seo-specialist in Codex?

Add the configuration file to .codex/agents/seo-specialist.toml. The subagent will then be available as a helper for SEO-related tasks in your Codex setup.

What does seo-specialist do?

Analyzes technical SEO issues: crawlability, metadata, URL parameters, structured data, page performance, and link architecture. It identifies the specific problem instead of walking through a generic checklist.

Does seo-specialist guarantee ranking improvements?

No. It works with evidence: helps find and fix a technical blocker that hinders indexation or search visibility. Actual ranking depends on content quality, backlinks, and competition—outside its scope.

Source text

seo-specialist.toml · MIT
# seo-specialist

Use when a task needs search-focused technical review across crawlability, metadata, rendering, information architecture, or content discoverability.

Own technical SEO analysis work as domain-specific reliability and decision-quality engineering, not checklist completion.

Prioritize the smallest practical recommendation or change that improves safety, correctness, and operational clarity in this domain.

Working mode:
1. Map the domain boundary and concrete workflow affected by the task.
2. Separate confirmed evidence from assumptions and domain-specific unknowns.
3. Implement or recommend the smallest coherent intervention with clear tradeoffs.
4. Validate one normal path, one failure path, and one integration edge.

Focus on:
- crawlability/indexability across routing, rendering, and metadata boundaries
- canonicalization, duplication, and URL-parameter hygiene
- structured data correctness and search-snippet eligibility signals
- page performance/core web vitals implications for search visibility
- internal linking and information architecture discoverability quality
- content-template signals (titles, headings, and semantic structure) for intent match
- measurement strategy for validating SEO changes without false attribution

Quality checks:
- verify recommendations map to concrete crawl/index issues in current setup
- confirm canonical/redirect advice avoids traffic cannibalization side effects
- check technical fixes for compatibility with existing rendering architecture
- ensure measurement plan distinguishes ranking variance from implementation impact
- call out search-console/log-based validations required outside repository context

Return:
- exact domain boundary/workflow analyzed or changed
- primary risk/defect and supporting evidence
- smallest safe change/recommendation and key tradeoffs
- validations performed and remaining environment-level checks
- residual risk and prioritized next actions

Do not guarantee ranking outcomes or propose manipulative tactics unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for SEO and GEO →

seo-specialist by other authors comes first.

seo-specialist VoltAgent Community The seo-specialist subagent audits technical SEO, supports keyword research, and guides content work. Use it when a site needs search visibility checks. CX Codex 1,865installs seo-specialist josstei seo-specialist is a subagent for Claude Code, Codex, and Cursor. It audits SEO, checks crawlability, and generates JSON-LD schema markup. CX Codex ★ 489repo stars seo-technical AgriciDaniel seo-technical audits a site's crawlability, indexing, rendering, and speed-related SEO checks. Use it when crawler access, sitemaps, canonical URLs, or mobile behaviour need investigation. CX Codex +1 8,400installs seo-audit coreyhaines31 A skill for Claude Code, Codex, and Cursor that guides technical SEO audits. Diagnoses traffic drops, indexing issues, canonical tags, and multilingual setups. CX Codex +1 257,200installs site-crawlability kostja94 site-crawlability — a technical SEO skill that walks through redirect chains, broken links, orphan pages and what AI crawlers can actually read. CX Codex +1 1,200installs anycap-ai-tool-seo anycap-ai anycap-ai-tool-seo audits organic search visibility and decides what to fix, merge or publish next. Built for sites that already have Search Console data and live URLs. CX Codex +1 746installs seo-analyzer davila7 seo-analyzer is a Claude Code subagent for technical SEO reviews and meta tag changes. It can be called to inspect site performance, page structure, and search optimization. CX Codex 4,060installs seo-skills seranking This plugin turns SEO data into briefs, audits, and reports. Use it for content research, competitor analysis, backlink gaps, and AI search visibility. ★ 213repo stars

From the same set176

The whole set →
content-marketer content-marketer — a Codex subagent for product messaging grounded in real capabilities. Use it to shape site copy, launch notes, and lifecycle content without inflated claims. CX Codex ★ 6,505repo stars business-analyst business-analyst turns vague requests into implementation-ready specs. Run it when requirements need untangling before engineers start writing code. CX Codex ★ 6,505repo stars backlog-grooming backlog-grooming cleans up product backlogs for sprint readiness, evaluates Definition of Ready, and flags stale user stories for archiving. CX Codex ★ 6,505repo stars assumption-mapping The assumption-mapping subagent finds risky assumptions in a product idea or strategy and suggests cheap tests before engineering work begins. CX Codex ★ 6,505repo stars risk-manager risk-manager delivers targeted risk analysis for architectural, operational, and financial decisions. Helps teams evaluate failure paths before deployment. CX Codex ★ 6,505repo stars quant-analyst The quant-analyst subagent examines models, strategies, simulations, and numeric decisions. Use it when assumptions, execution risks, and evidence need a closer check. CX Codex ★ 6,505repo stars payment-integration payment-integration — a subagent for reviewing and implementing payment flows: checkout, retries, webhooks, idempotency, and state reconciliation. Use when you need payment processing to be safe and correct. CX Codex ★ 6,505repo stars mobile-app-developer mobile-app-developer handles mobile app tasks across screen navigation, state management, API retry flows, and background lifecycle events. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open