Agent skill

SEO Technical

by AgriciDaniel in AgriciDaniel/codex-seo

Technical SEO audit across 9 categories: crawlability, indexability, security, URL structure, mobile, Core Web Vitals, structured data, JavaScript rendering, and IndexNow protocol.

MITAuto-check passedMarketing & SEO

Install SEO Technical

skills CLI
$ npx skills add AgriciDaniel/codex-seo --skill seo-technical -a claude-code

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

GitHub CLI
$ gh skill install AgriciDaniel/codex-seo seo-technical --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/AgriciDaniel/codex-seo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo-technical .claude/skills/seo-technical && 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-technical
GitHub stars
797
Used in
2 other repos
Token cost
~2.4k tokens
SKILL.md length
1,088 words
Files
2
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Technical SEO audit across 9 categories: crawlability, indexability, security, URL structure, mobile, Core Web Vitals, structured data, JavaScript rendering, and IndexNow protocol.

  • Works in 9 steps: Crawlability → Indexability → Security → …
  • User says technical SEO
  • SKILL.md covers Shared Data Cache, Categories, Output and DataForSEO Integration…, plus 3 more sections
  • Calls python

What it does

SEO Technical is an agent skill from AgriciDaniel/codex-seo. Technical SEO audit across 9 categories: crawlability, indexability, security, URL structure, mobile, Core Web Vitals, structured data, JavaScript rendering, and IndexNow protocol. Use when user says "technical SEO", "crawl issues", "robots.txt", "Core Web Vitals", "site speed", or "security headers".

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file.

It sits in Marketing & SEO, covering Technical SEO. It works with JavaScript and OpenAI. The repository describes itself as: Codex-first SEO skill suite. 26 workflows, 24 TOML agents, DataForSEO/Gemini/Google/Firecrawl integrations, GEO/AEO, CWV, schema, backlinks, local/maps, and deterministic reports. The licence is MIT.

When your agent uses it

  • User says technical SEO
  • Core Web Vitals
  • Security headers

Example prompts

  • “technical SEO”
  • “crawl issues”
  • “robots.txt”
  • “/seo-technical”

Requirements

  • Python 3

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Crawlability
  2. Indexability
  3. Security
  4. URL Structure
  5. Mobile Optimization
  6. Core Web Vitals
  7. Structured Data
  8. JavaScript Rendering
  9. IndexNow Protocol

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • python

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

  • Network

    No URLs in SKILL.md.

    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 Technical loads about 2.4k tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 1,088 words of instructions outside code blocks.

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

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 AgriciDaniel/codex-seo at commit 9a644f6, republished under its MIT licence (© AgriciDaniel). 1,088 words, ~2,387 tokens.

Download SKILL.mdSave it as .claude/skills/seo-technical/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
seo-technical
description
Technical SEO audit across 9 categories: crawlability, indexability, security, URL structure, mobile, Core Web Vitals, structured data, JavaScript rendering, and IndexNow protocol. Use when user says "technical SEO", "crawl issues", "robots.txt", "Core Web Vitals", "site speed", or "security headers".
user-invokable
true
argument-hint
[url]
license
MIT
metadata.author
AgriciDaniel
metadata.version
1.9.6
metadata.category
seo

Technical SEO Audit

Shared Data Cache

Step 0 -- Check shared data cache:

Before gathering, check .seo-cache/ for reusable context from related SEO skills. Reference: ../seo/references/shared-data-cache.md for schemas and dependency map.

Check these cache files when present:

  • .seo-cache/site-meta.json for domain, business type, industry, and crawl context

  • .seo-cache/audit-scores.json for prior full-audit priorities

  • .seo-cache/pages/{url-slug}/page-analysis.json for page-level context when a URL is provided

  • If found: parse and use clearly valid fields (note "Using cached [X] from [date]")

  • If missing, corrupt, or irrelevant: continue with fresh evidence

  • If the user says "refresh" or "re-run": ignore cache reads and overwrite on write

Categories

1. Crawlability
  • robots.txt: exists, valid, not blocking important resources
  • XML sitemap: exists, referenced in robots.txt, valid format
  • Noindex tags: intentional vs accidental
  • Crawl depth: important pages within 3 clicks of homepage
  • JavaScript rendering: check if critical content requires JS execution
  • Crawl budget: for large sites (>10k pages), efficiency matters
AI Crawler Management

As of 2025-2026, AI companies actively crawl the web to train models and power AI search. Managing these crawlers via robots.txt is a critical technical SEO consideration.

Known AI crawlers:

CrawlerCompanyrobots.txt tokenPurpose
GPTBotOpenAIGPTBotModel training
ChatGPT-UserOpenAIChatGPT-UserReal-time browsing
ClaudeBotAnthropicClaudeBotModel training
PerplexityBotPerplexityPerplexityBotSearch index + training
BytespiderByteDanceBytespiderModel training
Google-ExtendedGoogleGoogle-ExtendedGemini training (NOT search)
CCBotCommon CrawlCCBotOpen dataset

Key distinctions:

  • Blocking Google-Extended prevents Gemini training use but does NOT affect Google Search indexing or AI Overviews (those use Googlebot)
  • Blocking GPTBot prevents OpenAI training but does NOT prevent ChatGPT from citing your content via browsing (ChatGPT-User)
  • ~3-5% of websites now use AI-specific robots.txt rules

Example, selective AI crawler blocking:

# Allow search indexing, block AI training crawlers
User-agent: GPTBot
Disallow: /

User-agent: Google-Extended
Disallow: /

User-agent: Bytespider
Disallow: /

# Allow all other crawlers (including Googlebot for search)
User-agent: *
Allow: /

Recommendation: Consider your AI visibility strategy before blocking. Being cited by AI systems drives brand awareness and referral traffic. Cross-reference the seo-geo skill for full AI visibility optimization.

2. Indexability
  • Canonical tags: self-referencing, no conflicts with noindex
  • Duplicate content: near-duplicates, parameter URLs, www vs non-www
  • Thin content: pages below minimum word counts per type
  • Pagination: rel=next/prev or load-more pattern
  • Hreflang: correct for multi-language/multi-region sites
  • Index bloat: unnecessary pages consuming crawl budget
3. Security
  • HTTPS: enforced, valid SSL certificate, no mixed content
  • Security headers:
    • Content-Security-Policy (CSP)
    • Strict-Transport-Security (HSTS)
    • X-Frame-Options
    • X-Content-Type-Options
    • Referrer-Policy
  • HSTS preload: check preload list inclusion for high-security sites
4. URL Structure
  • Clean URLs: descriptive, hyphenated, no query parameters for content
  • Hierarchy: logical folder structure reflecting site architecture
  • Redirects: no chains (max 1 hop), 301 for permanent moves
  • URL length: flag >100 characters
  • Trailing slashes: consistent usage
5. Mobile Optimization
  • Responsive design: viewport meta tag, responsive CSS
  • Touch targets: minimum 48x48px with 8px spacing
  • Font size: minimum 16px base
  • No horizontal scroll
  • Mobile-first indexing: Google indexes mobile version. Mobile-first indexing is 100% complete as of July 5, 2024. Google now crawls and indexes ALL websites exclusively with the mobile Googlebot user-agent.
6. Core Web Vitals
  • LCP (Largest Contentful Paint): target <2.5s
  • INP (Interaction to Next Paint): target <200ms
    • INP replaced FID on March 12, 2024. FID was fully removed from all Chrome tools (CrUX API, PageSpeed Insights, Lighthouse) on September 9, 2024. Do NOT reference FID anywhere.
  • CLS (Cumulative Layout Shift): target <0.1
  • Evaluation uses 75th percentile of real user data
  • Use PageSpeed Insights API or CrUX data if MCP available
7. Structured Data
  • Detection: JSON-LD (preferred), Microdata, RDFa
  • Validation against Google's supported types
  • See seo-schema skill for full analysis
8. JavaScript Rendering
  • Check if content visible in initial HTML vs requires JS
  • Identify client-side rendered (CSR) vs server-side rendered (SSR)
  • Flag SPA frameworks (React, Vue, Angular) that may cause indexing issues
  • Verify dynamic rendering setup if applicable
Show full SKILL.md (496 more words)Show less
JavaScript SEO: Canonical & Indexing Guidance (December 2025)

Google updated its JavaScript SEO documentation in December 2025 with critical clarifications:

  1. Canonical conflicts: If a canonical tag in raw HTML differs from one injected by JavaScript, Google may use EITHER one. Ensure canonical tags are identical between server-rendered HTML and JS-rendered output.
  2. noindex with JavaScript: If raw HTML contains <meta name="robots" content="noindex"> but JavaScript removes it, Google MAY still honor the noindex from raw HTML. Serve correct robots directives in the initial HTML response.
  3. Non-200 status codes: Google does NOT render JavaScript on pages returning non-200 HTTP status codes. Any content or meta tags injected via JS on error pages will be invisible to Googlebot.
  4. Structured data in JavaScript: Product, Article, and other structured data injected via JS may face delayed processing. For time-sensitive structured data (especially e-commerce Product markup), include it in the initial server-rendered HTML.

Best practice: Serve critical SEO elements (canonical, meta robots, structured data, title, meta description) in the initial server-rendered HTML rather than relying on JavaScript injection.

9. IndexNow Protocol
  • Check if site supports IndexNow for Bing, Yandex, Naver
  • Supported by search engines other than Google
  • Recommend implementation for faster indexing on non-Google engines

Output

Technical Score: XX/100
Category Breakdown
CategoryStatusScore
Crawlabilitypass/warn/failXX/100
Indexabilitypass/warn/failXX/100
Securitypass/warn/failXX/100
URL Structurepass/warn/failXX/100
Mobilepass/warn/failXX/100
Core Web Vitalspass/warn/failXX/100
Structured Datapass/warn/failXX/100
JS Renderingpass/warn/failXX/100
IndexNowpass/warn/failXX/100
Critical Issues (fix immediately)
High Priority (fix within 1 week)
Medium Priority (fix within 1 month)
Low Priority (backlog)

DataForSEO Integration (Optional)

If DataForSEO MCP tools are available, use on_page_instant_pages for real page analysis (status codes, page timing, broken links, on-page checks), on_page_lighthouse for Lighthouse audits (performance, accessibility, SEO scores), and domain_analytics_technologies_domain_technologies for technology stack detection.

Google API Integration (Optional)

If Google API credentials are configured, use python scripts/pagespeed_check.py <url> --json for real PSI + CrUX field data (replaces lab-only CWV estimates), python scripts/crux_history.py <url> --json for 25-week CWV trends, and python scripts/gsc_inspect.py <url> --json for real indexation status per URL.

Error Handling

ScenarioAction
URL unreachableReport connection error with status code. Suggest verifying URL, checking DNS resolution, and confirming the site is publicly accessible.
robots.txt not foundNote that no robots.txt was detected at the root domain. Recommend creating one with appropriate directives. Continue audit on remaining categories.
HTTPS not configuredFlag as a critical issue. Report whether HTTP is served without redirect, mixed content exists, or SSL certificate is missing/expired.
Core Web Vitals data unavailableNote that CrUX data is not available (common for low-traffic sites). Suggest using Lighthouse lab data as a proxy and recommend increasing traffic before re-testing.

Write to shared data cache

After completing all work, write a concise JSON summary to .seo-cache/ when the workflow produced durable findings. Use the schemas and naming rules in ../seo/references/shared-data-cache.md; include at least cache_type, analyzed_at, source URL/domain, key findings, issues, recommendations, and tool limitations. Add .seo-cache/ to .gitignore if it is missing.

© AgriciDaniel, 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 1 other file in skills/seo-technical of AgriciDaniel/codex-seo.

  • SKILL.md
  • LICENSE.txt

Open the folder on GitHubat commit 9a644f6

Used in 3 other repositories

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

Compare with similar skills

SEO Technical 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 Technical compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Technical this skillAgriciDaniel/codex-seo7972 repos~2.4kAutomated safety check: PassMIT
Qiaomu SEOjoeseesun/qiaomu-seo441—~2.6kAutomated safety check: PassMIT
SEO Technicalsickn33/agentic-awesome-skills47k2 repos~2.2kAutomated safety check: NotesMIT
Agent Readiness Auditindranilbanerjee/digital-marketing-pro8591 repos~3.9kAutomated safety check: PassMIT
GEO-First SEO Audit Toolzubair-trabzada/geo-seo-claude11k—~2.8kAutomated safety check: NotesMIT
SEOAgriciDaniel/seo-os1352 repos~3.5kAutomated safety check: PassMIT

Similar skills

  • Qiaomu SEO

    joeseesun/qiaomu-seo

    Audit, diagnose, research, plan, implement, experiment on, and verify website SEO across Google, Bing, and AI-search surfaces.

    441 GitHub stars~2.6k tokensUpdated 2 mo ago
    Marketing & SEOAuto-check passed
  • SEO Technical

    sickn33/agentic-awesome-skills

    Audit technical SEO across crawlability, indexability, security, URLs, mobile, Core Web Vitals, structured data, JavaScript rendering, and related platform signals like robots.txt and AI crawler…

    47k GitHub starsUsed in 2 repos~2.2k tokens
    Marketing & SEOAuto-check: notes
  • Agent Readiness Audit

    indranilbanerjee/digital-marketing-pro

    Audit whether AI agents and AI crawlers can actually use a site — robots.txt rules per AI crawler token (OpenAI, Anthropic and Perplexity bots, Google-Extended, Applebot-Extended)…

    859 GitHub starsUsed in 1 repo~3.9k tokens
    Data & AnalyticsAuto-check passed
  • GEO-First SEO Audit Tool

    zubair-trabzada/geo-seo-claude

    Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality.

    11k GitHub stars~2.8k tokensUpdated today
    Marketing & SEOAuto-check: notes
  • SEO

    AgriciDaniel/seo-os

    Comprehensive SEO analysis for any website or business type.

    135 GitHub starsUsed in 2 repos~3.5k tokens
    Marketing & SEOAuto-check passed
  • SEO Audit

    umutxyp/Seo-Promt-Master

    Audit and fix a website's technical SEO and AI-search (GEO) readiness against Google's official guidance (plus Bing, Yandex, Apple and the AI crawlers), page by page, ending in a computed SEO/GEO…

    557 GitHub stars~1.4k tokensUpdated 5 days ago
    Marketing & SEOAuto-check passed

More from AgriciDaniel/codex-seo

All 18 skills in this repo
  • SEO Google

    AgriciDaniel/codex-seo

    Google SEO APIs: Search Console (Search Analytics, URL Inspection, Sitemaps), PageSpeed Insights v5, CrUX field data with 25-week history, Indexing API v3, and GA4 organic traffic.

    797 GitHub starsUsed in 2 repos~3.4k tokens
    Auto-check passed
  • SEO Dataforseo

    AgriciDaniel/codex-seo

    Live SEO data via DataForSEO MCP server. An agent skill from AgriciDaniel/codex-seo.

    797 GitHub starsUsed in 2 repos~4.6k tokens
    Auto-check passed
  • SEO Ecommerce

    AgriciDaniel/codex-seo

    E-commerce SEO analysis: Google Shopping visibility, Amazon marketplace intelligence, product schema validation, competitor pricing analysis, and marketplace keyword gaps.

    797 GitHub starsUsed in 2 repos~3k tokens
    Auto-check passed
  • SEO Sxo

    AgriciDaniel/codex-seo

    Search Experience Optimization: reads Google SERPs backwards to detect page-type mismatches, derives user stories from search intent signals, and scores pages from multiple persona perspectives.

    797 GitHub starsUsed in 2 repos~2.9k tokens
    Auto-check passed
  • SEO Page

    AgriciDaniel/codex-seo

    Deep single-page SEO analysis covering on-page elements, content quality, technical meta tags, schema, images, and performance.

    797 GitHub starsUsed in 5 repos~1.2k tokens
    Auto-check passed
  • SEO Schema

    AgriciDaniel/codex-seo

    Detect, validate, and generate Schema.org structured data. An agent skill from AgriciDaniel/codex-seo.

    797 GitHub starsUsed in 5 repos~1.6k tokens
    Auto-check passed

Categories

Questions about SEO Technical

What does SEO Technical do?

Technical SEO audit across 9 categories: crawlability, indexability, security, URL structure, mobile, Core Web Vitals, structured data, JavaScript rendering, and IndexNow protocol. SEO Technical is an agent skill from AgriciDaniel/codex-seo. Technical SEO audit across 9 categories: crawlability, indexability, security, URL structure, mobile, Core Web Vitals, structured data, JavaScript rendering, and IndexNow protocol.

When should I use SEO Technical?

SEO Technical fits situations like: user says technical SEO; core Web Vitals; security headers.

How do I install SEO Technical in Claude Code?

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

How do I install SEO Technical in Codex?

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

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

What does SEO Technical need to run?

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

Does SEO Technical access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

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

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

About 2.4k tokens (SKILL.md is roughly 9.5k 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 Technical?

Skills that share tags, products or a category with SEO Technical: Qiaomu SEO (joeseesun/qiaomu-seo, 441 stars), SEO Technical (sickn33/agentic-awesome-skills, 47k stars), Agent Readiness Audit (indranilbanerjee/digital-marketing-pro, 859 stars) and GEO-First SEO Audit Tool (zubair-trabzada/geo-seo-claude, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Technical?

AgriciDaniel (a GitHub user) maintains it in AgriciDaniel/codex-seo, which has 797 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on September 11, 2026.

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