30x-seo-geo-technical

Installation

$npx skills add norahe0304-art/30x-seo --skill 30x-seo-geo-technical

Summary

Audit website accessibility for AI crawlers (GPTBot, ClaudeBot, PerplexityBot) and generate fixes for robots.txt, llms.txt, and server-side rendering issues. Invoke when user needs to optimize for AI search platforms or ensure AI citability.

SKILL.MD

GEO Technical (AI Search Technical Check)

What This Skill Does

Check website's technical accessibility for AI search engines, find issues and help fix them.

Does NOT do:

  • Content quality analysis → use seo-content-audit (E-E-A-T + AI citability)

Process

Step 1: Check AI Crawler Access

Read robots.txt and check if these crawlers are allowed:

CrawlerOwnerPurposeRecommendation
GPTBotOpenAIChatGPT Search✅ Allow
OAI-SearchBotOpenAIOpenAI Search✅ Allow
ChatGPT-UserOpenAIChatGPT Browsing✅ Allow
ClaudeBotAnthropicClaude Search✅ Allow
PerplexityBotPerplexityPerplexity AI✅ Allow
CCBotCommon CrawlTraining data⚠️ Optional block
anthropic-aiAnthropicClaude Training⚠️ Optional block
BytespiderByteDanceTikTok AI⚠️ Optional block

Problem Examples:

❌ GPTBot blocked → ChatGPT can't cite your content
❌ PerplexityBot blocked → Perplexity can't cite you

Fix Output:

# robots.txt modification suggestion
User-agent: GPTBot
Allow: /

User-agent: ClaudeBot
Allow: /

User-agent: PerplexityBot
Allow: /

Step 2: Check llms.txt

Check if /llms.txt exists:

StatusDescription
✅ Exists and completeHas title, description, key page list
⚠️ Exists but incompleteMissing key information
❌ Does not existNeeds creation

Fix Output (generate llms.txt):

# [Website Name]
> [One-line description]

## Core Pages
- [Homepage](https://example.com/): Website homepage
- [Products](https://example.com/products): Product list
- [About Us](https://example.com/about): Company introduction

## Key Information
- Founded in XXXX
- Serving XXX customers
- Main business: XXX

Step 3: Check Server-Side Rendering

AI crawlers don't execute JavaScript - key content must be directly visible in HTML.

Check method:

  1. Access page with JavaScript disabled
  2. Check if key content is visible
StatusDescription
✅ SSRKey content in HTML
❌ CSRKey content requires JS to load

Problem Examples:

❌ Product descriptions only appear after JS rendering
❌ Article body depends on React hydration

Fix Recommendations:

  • Use SSR/SSG frameworks (Next.js, Nuxt, Astro)
  • Pre-render key pages
  • Ensure <noscript> has content

Step 4: Platform-Specific Check

PlatformTechnical Requirements
Google AI OverviewsTraditional SEO basics + Schema
ChatGPTGPTBot access + llms.txt
PerplexityPerplexityBot access
Bing CopilotBing indexing + IndexNow

Output

1. GEO Technical Report

# GEO Technical Report

## AI Crawler Access Status
| Crawler | Status | Issue |
|---------|--------|-------|
| GPTBot | ✅ Allowed | — |
| ClaudeBot | ❌ Blocked | robots.txt line 12 |
| PerplexityBot | ✅ Allowed | — |

## llms.txt Status
❌ Does not exist

## SSR Status
⚠️ Some pages depend on JS

## Issues Summary
1. ClaudeBot is blocked
2. Missing llms.txt
3. /products page content depends on JS

2. Fix Code

# Fix Recommendations

## robots.txt Modification
[Generate modified robots.txt]

## llms.txt Generation
[Generate complete llms.txt]

## SSR Fix Recommendations
- Page /products needs SSR enabled
- Recommend migrating to Next.js SSG

Reference: AI Crawler Details

Complete robots.txt Configuration Example

# AI Search Crawlers (Allow)
User-agent: GPTBot
Allow: /

User-agent: OAI-SearchBot
Allow: /

User-agent: ChatGPT-User
Allow: /

User-agent: ClaudeBot
Allow: /

User-agent: PerplexityBot
Allow: /

# AI Training Crawlers (Optional Block)
User-agent: CCBot
Disallow: /

User-agent: anthropic-ai
Disallow: /

Complete llms.txt Format

# Site Name
> Brief description of the site

## Main Sections
- [Page Title](url): Description
- [Another Page](url): Description

## Key Facts
- Fact 1
- Fact 2

## Contact
- Email: xxx
- Social: xxx

RSL 1.0 (Really Simple Licensing)

Machine-readable AI licensing terms (2025.12).

Supporters: Reddit, Yahoo, Medium, Quora, Cloudflare, Akamai, Creative Commons


Integration

Related SkillUsage
seo-technicalTraditional technical SEO checks
seo-content-auditContent quality + AI citability analysis

[PROTOCOL]: Update this header on changes, then check CLAUDE.md