[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AFPN36A0YNTS2CZM6N2GXZ":3,"skill-same:01M7AFPN36A0YNTS2CZM6N2GXZ":57},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":35,"commitSha":36,"skillDirectory":37,"forksCount":38,"repositoryHtmlUrl":39,"repositoryHomepageUrl":6,"ownerHtmlUrl":40,"ownerBlogUrl":41,"ownerDescription":6,"updatedAt":42,"install":43,"resources":56},"01M7AFPN36A0YNTS2CZM6N2GXZ","geo-technical",null,"Technical SEO audit with GEO-specific checks — crawlability, indexability, security, performance, SSR, and AI crawler access","iamwaqargulzar\u002FMarketing-Agent-OS","iamwaqargulzar","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F96654715?v=4","01M7ACMBN0TACNXY53QYG8KDF6","Waqar Gulzar","01M7ACMBNP5ZX60H8CD3JK0633",8,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar\u002FMarketing-Agent-OS\u002Fblob\u002Fmain\u002Fupstreams\u002Fsource-c\u002Fskills\u002Fgeo-technical\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: geo-technical\ndescription: Technical SEO audit with GEO-specific checks — crawlability, indexability, security, performance, SSR, and AI crawler access\nversion: 1.0.0\nauthor: geo-seo-claude\ntags: [geo, technical-seo, core-web-vitals, ssr, crawlability, security, performance]\nallowed-tools: Read, Grep, Glob, Bash, WebFetch, Write\n---\n\n# GEO Technical SEO Audit\n\n## Purpose\n\nTechnical SEO forms the foundation of both traditional search visibility and AI search citation. A technically broken site cannot be crawled, indexed, or cited by any platform. This skill audits 8 categories of technical health with specific attention to GEO requirements — most critically, **server-side rendering** (AI crawlers do not execute JavaScript) and **AI crawler access** (many sites inadvertently block AI crawlers in robots.txt).\n\n## How to Use This Skill\n\n1. Collect the target URL (homepage + 2-3 key inner pages)\n2. Fetch each page using curl\u002FWebFetch to get raw HTML and HTTP headers\n3. Run through each of the 8 audit categories below\n4. Score each category using the rubric\n5. Generate GEO-TECHNICAL-AUDIT.md with results\n\n---\n\n## Category 1: Crawlability (15 points)\n\n### 1.1 robots.txt Validity\n- Fetch `https:\u002F\u002F[domain]\u002Frobots.txt`\n- Check for syntactic validity: proper `User-agent`, `Allow`, `Disallow` directives\n- Check for common errors: missing User-agent, wildcards blocking important paths, Disallow: \u002F blocking entire site\n- Verify XML sitemap is referenced: `Sitemap: https:\u002F\u002F[domain]\u002Fsitemap.xml`\n\n### 1.2 AI Crawler Access (CRITICAL for GEO)\nCheck robots.txt for directives targeting these AI crawlers:\n\n| Crawler | User-Agent | Platform |\n|---|---|---|\n| GPTBot | GPTBot | ChatGPT \u002F OpenAI |\n| Google-Extended | Google-Extended | Gemini \u002F Google AI training |\n| Googlebot | Googlebot | Google Search + AI Overviews |\n| Bingbot | bingbot | Bing Copilot + ChatGPT (via Bing) |\n| PerplexityBot | PerplexityBot | Perplexity AI |\n| ClaudeBot | ClaudeBot | Anthropic Claude |\n| Amazonbot | Amazonbot | Alexa \u002F Amazon AI |\n| CCBot | CCBot | Common Crawl (used by many AI models) |\n| FacebookBot | FacebookExternalHit | Meta AI |\n| Bytespider | Bytespider | TikTok \u002F ByteDance AI |\n| Applebot-Extended | Applebot-Extended | Apple Intelligence |\n\n**Scoring for AI crawler access:**\n- All major AI crawlers allowed: 5 points\n- Some blocked but Googlebot + Bingbot allowed: 3 points\n- GPTBot or PerplexityBot blocked: 1 point (significant GEO impact)\n- Googlebot blocked: 0 points (fatal)\n\n**Important nuance**: Blocking Google-Extended does NOT block Googlebot. Google-Extended only controls AI training data usage, not search indexing. However, blocking Google-Extended may reduce presence in AI Overviews. Recommend allowing Google-Extended unless there is a specific data licensing concern.\n\n### 1.3 XML Sitemaps\n- Fetch sitemap (check robots.txt for location, or try `\u002Fsitemap.xml`, `\u002Fsitemap_index.xml`)\n- Validate XML syntax\n- Check for `\u003Clastmod>` dates (should be present and accurate)\n- Count URLs — compare to expected number of indexable pages\n- Check for sitemap index if large site (50,000+ URLs per sitemap max)\n- Verify all sitemap URLs return 200 status codes (sample check)\n\n### 1.4 Crawl Depth\n- Homepage = depth 0. Check that all important pages are reachable within **3 clicks** (depth 3)\n- Pages at depth 4+ receive significantly less crawl budget and are less likely to be cited by AI\n- Check internal linking: are key content pages linked from the homepage or main navigation?\n\n### 1.5 Noindex Management\n- Check for `\u003Cmeta name=\"robots\" content=\"noindex\">` on pages that SHOULD be indexed\n- Check for `X-Robots-Tag: noindex` HTTP headers\n- Common mistakes: noindex on paginated pages, category pages, or key landing pages\n\n**Category Scoring:**\n| Check | Points |\n|---|---|\n| robots.txt valid and complete | 3 |\n| AI crawlers allowed | 5 |\n| XML sitemap present and valid | 3 |\n| Crawl depth within 3 clicks | 2 |\n| No erroneous noindex directives | 2 |\n\n---\n\n## Category 2: Indexability (12 points)\n\n### 2.1 Canonical Tags\n- Every indexable page must have a `\u003Clink rel=\"canonical\" href=\"...\">` tag\n- Canonical must point to itself (self-referencing) for the authoritative version\n- Check for conflicting canonicals (canonical in HTML vs. HTTP header)\n- Check for canonical chains (A canonicals to B, B canonicals to C — should be A to C)\n\n### 2.2 Duplicate Content\n- Check for www vs. non-www (both should resolve, one should redirect)\n- Check for HTTP vs. HTTPS (HTTP should redirect to HTTPS)\n- Check for trailing slash consistency (pick one pattern and redirect the other)\n- Check for parameter-based duplicates (`?sort=price` creating duplicate pages)\n\n### 2.3 Pagination\n- If paginated content exists, check for `rel=\"next\"` \u002F `rel=\"prev\"` (note: Google ignores these as of 2019, but Bing still uses them)\n- Preferred: use `rel=\"canonical\"` on paginated pages pointing to a view-all page or the first page\n- Ensure paginated pages are not noindexed if they contain unique content\n\n### 2.4 Hreflang (international sites)\n- Check for `\u003Clink rel=\"alternate\" hreflang=\"xx\">` tags\n- Validate: reciprocal hreflang (if page A points to page B, B must point back to A)\n- Validate: x-default fallback exists\n- Check for language\u002Fregion code validity (ISO 639-1 \u002F ISO 3166-1)\n\n### 2.5 Index Bloat\n- Estimate number of indexed pages (check sitemap count, use `site:domain.com` estimate)\n- Compare indexed pages to actual valuable content pages\n- Flag if indexed pages significantly exceed content pages (index bloat from thin\u002Fduplicate\u002Fparameter pages)\n\n**Category Scoring:**\n| Check | Points |\n|---|---|\n| Canonical tags correct on all pages | 3 |\n| No duplicate content issues | 3 |\n| Pagination handled correctly | 2 |\n| Hreflang correct (if applicable) | 2 |\n| No index bloat | 2 |\n\n---\n\n## Category 3: Security (10 points)\n\n### 3.1 HTTPS Enforcement\n- Site must load over HTTPS\n- HTTP must redirect to HTTPS (301 redirect)\n- No mixed content warnings (HTTP resources on HTTPS pages)\n- SSL\u002FTLS certificate must be valid and not expired\n\n### 3.2 Security Headers\nCheck HTTP response headers for:\n\n| Header | Required Value | Purpose |\n|---|---|---|\n| `Strict-Transport-Security` | `max-age=31536000; includeSubDomains` | Forces HTTPS |\n| `Content-Security-Policy` | Appropriate policy | Prevents XSS |\n| `X-Content-Type-Options` | `nosniff` | Prevents MIME sniffing |\n| `X-Frame-Options` | `DENY` or `SAMEORIGIN` | Prevents clickjacking |\n| `Referrer-Policy` | `strict-origin-when-cross-origin` or stricter | Controls referrer data |\n| `Permissions-Policy` | Appropriate restrictions | Controls browser features |\n\n**Category Scoring:**\n| Check | Points |\n|---|---|\n| HTTPS enforced with valid cert | 4 |\n| HSTS header present | 2 |\n| X-Content-Type-Options | 1 |\n| X-Frame-Options | 1 |\n| Referrer-Policy | 1 |\n| Content-Security-Policy | 1 |\n\n---\n\n## Category 4: URL Structure (8 points)\n\n### 4.1 Clean URLs\n- URLs should be human-readable: `\u002Fblog\u002Fseo-guide` not `\u002Fblog?id=12345`\n- No session IDs in URLs\n- Lowercase only (no mixed case)\n- Hyphens for word separation (not underscores)\n- No special characters or encoded spaces\n\n### 4.2 Logical Hierarchy\n- URL path should reflect site architecture: `\u002Fcategory\u002Fsubcategory\u002Fpage`\n- Flat where appropriate — avoid unnecessarily deep nesting\n- Consistent pattern across the site\n\n### 4.3 Redirect Chains\n- Check for redirect chains (A redirects to B redirects to C)\n- Maximum 1 hop recommended (A redirects to C directly)\n- Check for redirect loops\n- All redirects should be 301 (permanent), not 302 (temporary), unless intentionally temporary\n\n### 4.4 Parameter Handling\n- URL parameters should not create duplicate indexable pages\n- Use canonical tags or `robots.txt` Disallow for parameter variations\n- Configure parameter handling in Google Search Console and Bing Webmaster Tools\n\n**Category Scoring:**\n| Check | Points |\n|---|---|\n| Clean, readable URLs | 2 |\n| Logical hierarchy | 2 |\n| No redirect chains (max 1 hop) | 2 |\n| Parameter handling configured | 2 |\n\n---\n\n## Category 5: Mobile Optimization (10 points)\n\n### Critical Context\nAs of **July 2024**, Google crawls ALL sites exclusively with mobile Googlebot. There is no desktop crawling. If your site does not work on mobile, it does not work for Google. Period.\n\n### 5.1 Responsive Design\n- Check for `\u003Cmeta name=\"viewport\" content=\"width=device-width, initial-scale=1\">`\n- Content must not require horizontal scrolling on mobile\n- No fixed-width layouts wider than viewport\n\n### 5.2 Tap Targets\n- Interactive elements (buttons, links) must be at least 48x48 CSS pixels\n- Minimum 8px spacing between tap targets\n- Check that navigation is usable on mobile\n\n### 5.3 Font Sizes\n- Base font size should be at least 16px\n- No text requiring zoom to read\n- Sufficient contrast ratio (WCAG AA: 4.5:1 for normal text, 3:1 for large text)\n\n### 5.4 Mobile Content Parity\n- All content visible on desktop must also be visible on mobile\n- No hidden content behind \"read more\" toggles that Googlebot cannot expand (though Google has improved at expanding these as of 2025)\n- Images and media must load on mobile\n\n**Category Scoring:**\n| Check | Points |\n|---|---|\n| Viewport meta tag correct | 3 |\n| Responsive layout (no horizontal scroll) | 3 |\n| Tap targets appropriately sized | 2 |\n| Font sizes legible | 2 |\n\n---\n\n## Category 6: Core Web Vitals (15 points)\n\n### 2026 Metrics and Thresholds\nCore Web Vitals use the **75th percentile** of real user data (field data) as the benchmark. Lab data is useful for debugging but field data determines the ranking signal.\n\n| Metric | Good | Needs Improvement | Poor | Notes |\n|---|---|---|---|---|\n| **LCP** (Largest Contentful Paint) | \u003C 2.5s | 2.5s - 4.0s | > 4.0s | Measures loading — time until largest visible element renders |\n| **INP** (Interaction to Next Paint) | \u003C 200ms | 200ms - 500ms | > 500ms | Replaced FID in March 2024. Measures ALL interactions, not just first |\n| **CLS** (Cumulative Layout Shift) | \u003C 0.1 | 0.1 - 0.25 | > 0.25 | Measures visual stability — unexpected layout movements |\n\n### How to Assess Without CrUX Data\nWhen real user data is unavailable, estimate from page characteristics:\n- **LCP**: Check largest above-fold element. Is it an image (check size\u002Fformat)? Is it text (check web font loading)? Server response time (TTFB)?\n- **INP**: Check for heavy JavaScript on page. Long tasks (>50ms) block interactivity. Check for third-party scripts.\n- **CLS**: Check for images without explicit width\u002Fheight. Check for dynamically inserted content above the fold. Check for web fonts causing layout shift (FOUT\u002FFOIT).\n\n### Common LCP Fixes\n1. Optimize hero images: WebP\u002FAVIF format, correct sizing, preload with `\u003Clink rel=\"preload\">`\n2. Reduce server response time (TTFB \u003C 800ms)\n3. Eliminate render-blocking CSS\u002FJS\n4. Preconnect to critical third-party origins\n\n### Common INP Fixes\n1. Break up long tasks (>50ms) into smaller chunks using `requestIdleCallback` or `scheduler.yield()`\n2. Reduce third-party JavaScript\n3. Use `content-visibility: auto` for off-screen content\n4. Debounce\u002Fthrottle event handlers\n\n### Common CLS Fixes\n1. Always include `width` and `height` attributes on images and videos\n2. Reserve space for ads and embeds with CSS `aspect-ratio` or explicit dimensions\n3. Use `font-display: swap` with size-adjusted fallback fonts\n4. Avoid inserting content above existing content after page load\n\n**Category Scoring:**\n| Check | Points |\n|---|---|\n| LCP \u003C 2.5s | 5 |\n| INP \u003C 200ms | 5 |\n| CLS \u003C 0.1 | 5 |\n\n---\n\n## Category 7: Server-Side Rendering (15 points) — CRITICAL FOR GEO\n\n### Why SSR Is Mandatory for AI Visibility\nAI crawlers (GPTBot, PerplexityBot, ClaudeBot, etc.) do **NOT execute JavaScript**. They fetch the raw HTML and parse it. If your content is rendered client-side by React, Vue, Angular, or any other JavaScript framework, AI crawlers see an empty page.\n\nEven Googlebot, which does execute JavaScript, deprioritizes JS-rendered content due to the additional crawl budget required. Google processes JS rendering in a separate \"rendering queue\" that can delay indexing by days or weeks.\n\n### Detection Method\n1. Fetch the page with curl (no JavaScript execution): `curl -s [URL]`\n2. Compare the raw HTML to the rendered DOM (via browser)\n3. If key content (headings, paragraphs, product info, article text) is MISSING from the curl output, the site relies on client-side rendering\n\n### What to Check\n- **Main content text**: Is the article body \u002F product description \u002F page content in the raw HTML?\n- **Headings**: Are H1, H2, H3 tags present in raw HTML?\n- **Navigation**: Is the main navigation server-rendered?\n- **Structured data**: Is JSON-LD in the raw HTML or injected by JavaScript?\n- **Meta tags**: Are title, description, canonical, OG tags in the raw HTML?\n- **Internal links**: Are navigation and content links in the raw HTML? (Critical for crawlability)\n\n### SSR Solutions to Recommend\n| Framework | SSR Solution |\n|---|---|\n| React | Next.js (SSR\u002FSSG), Remix, Gatsby (SSG) |\n| Vue | Nuxt.js (SSR\u002FSSG) |\n| Angular | Angular Universal |\n| Svelte | SvelteKit |\n| Generic | Prerender.io (prerendering service), Rendertron |\n\n### Scoring Detail\n- All key content server-rendered: 15 points\n- Main content server-rendered but some elements JS-only: 10 points\n- Critical content requires JS (product info, article text): 5 points\n- Entire page is client-rendered (empty body in raw HTML): 0 points\n\n**Category Scoring:**\n| Check | Points |\n|---|---|\n| Main content in raw HTML | 8 |\n| Meta tags + structured data in raw HTML | 4 |\n| Internal links in raw HTML | 3 |\n\n---\n\n## Category 8: Page Speed & Server Performance (15 points)\n\n### 8.1 Time to First Byte (TTFB)\n- Target: **\u003C 800ms** (ideally \u003C 200ms)\n- Measure with curl: `curl -o \u002Fdev\u002Fnull -s -w 'TTFB: %{time_starttransfer}s\\n' [URL]`\n- If TTFB > 800ms: check server location, caching, database queries, CDN usage\n\n### 8.2 Resource Optimization\n- Total page weight target: **\u003C 2MB** (critical pages \u003C 1MB)\n- Check for uncompressed resources (gzip\u002Fbrotli compression should be enabled)\n- Check for unminified CSS and JavaScript\n- Check for unused CSS\u002FJS (can represent 50%+ of downloaded bytes on many sites)\n\n### 8.3 Image Optimization\n- Check image formats: WebP or AVIF preferred over JPEG\u002FPNG\n- Check for oversized images (images larger than display size)\n- Check for lazy loading: images below fold should have `loading=\"lazy\"`\n- Check for explicit dimensions (width\u002Fheight attributes prevent CLS)\n- Above-fold images should NOT be lazy loaded (harms LCP)\n\n### 8.4 Code Splitting and Lazy Loading\n- JavaScript should be code-split so each page only loads what it needs\n- Check for large JavaScript bundles (> 200KB compressed is a warning, > 500KB is critical)\n- Third-party scripts should load asynchronously (`async` or `defer`)\n- Check for render-blocking resources in `\u003Chead>`\n\n### 8.5 Caching\n- Check `Cache-Control` headers on static resources (images, CSS, JS)\n- Static assets should have long cache times: `max-age=31536000` (1 year) with content-hashed filenames\n- HTML pages should have shorter cache or `no-cache` with validation (`ETag` or `Last-Modified`)\n\n### 8.6 CDN Usage\n- Check if static resources are served from a CDN (different domain or CDN-specific headers)\n- For global audience, CDN is critical for consistent performance\n- Check for CDN-specific headers: `CF-Ray` (Cloudflare), `X-Cache` (AWS CloudFront), `X-Served-By` (Fastly)\n\n**Category Scoring:**\n| Check | Points |\n|---|---|\n| TTFB \u003C 800ms | 3 |\n| Page weight \u003C 2MB | 2 |\n| Images optimized (format, size, lazy) | 3 |\n| JS bundles reasonable (\u003C 200KB compressed) | 2 |\n| Compression enabled (gzip\u002Fbrotli) | 2 |\n| Cache headers on static resources | 2 |\n| CDN in use | 1 |\n\n---\n\n## Category 9: Agent-Readiness Signals (non-scoring)\n\nThese checks surface emerging AI agent compatibility signals. None contribute to the numeric score — they produce a pass or a recommendation. The underlying standards are either IETF drafts or early-adoption features; penalizing absence would be unfair.\n\n### 9.1 RFC 8288 Link Headers (Service Discovery)\n\nRFC 8288 (Web Linking) defines the HTTP `Link:` response header. Servers can use it to advertise related resources — API catalog, service docs, MCP server card — in a machine-readable way, without HTML parsing.\n\n**How to check:** Capture all `Link:` response headers from the standard homepage fetch (no extra request).\n\n**What to look for:**\n- Parse `\u003Curl>; rel=\"relation-type\"` pairs.\n- High-value rel types: `api-catalog` (RFC 9609), `describedby`, `service-doc`, `mcp-server-card`.\n\n**When to surface a recommendation:** Only for API-first sites (API docs linked in nav, `\u002Fapi\u002F` or `\u002Fdevelopers\u002F` paths, swagger\u002FOpenAPI in sitemap). Omit this section entirely for standard business sites — absence is expected and not noteworthy.\n\n| State | Treatment |\n|---|---|\n| `Link:` headers present, known rel types | Informational — document what was found |\n| `Link:` headers present, unknown rel types | Informational — note and explain |\n| Absent, API-first site | Recommendation — explain and suggest implementation |\n| Absent, standard business site | Omit — do not surface |\n\n### 9.2 Markdown Content Negotiation\n\nChecks if the server responds to `Accept: text\u002Fmarkdown` with `Content-Type: text\u002Fmarkdown`. Cloudflare's \"Markdown for Agents\" feature enables this — AI agents receive clean Markdown instead of HTML, eliminating boilerplate stripping and improving content extraction accuracy.\n\n**How to check:** Send a GET to the homepage with `Accept: text\u002Fmarkdown`. This is one additional HTTP request per audit.\n\n**Evaluation:**\n- If response `Content-Type` is `text\u002Fmarkdown` (or `text\u002Fmarkdown; charset=utf-8`): pass — note as a leading-edge capability.\n- Otherwise: forward-looking recommendation, not a failure.\n- If the request errors or returns non-200: skip and note the error. Do not penalize.\n\n| State | Treatment |\n|---|---|\n| `text\u002Fmarkdown` returned | Bonus — note as a leading-edge capability |\n| Standard HTML returned | Forward-looking recommendation |\n| Request errors \u002F non-200 | Skip, note the error, do not penalize |\n\n---\n\n## IndexNow Protocol\n\n### What It Is\nIndexNow is an open protocol that allows websites to notify search engines instantly when content is created, updated, or deleted. Supported by Bing, Yandex, Seznam, and Naver. Google does NOT support IndexNow but monitors the protocol.\n\n### Why It Matters for GEO\nChatGPT uses Bing's index. Bing Copilot uses Bing's index. Faster Bing indexing means faster AI visibility on two major platforms.\n\n### Implementation Check\n1. Check for IndexNow key file: `https:\u002F\u002F[domain]\u002F.well-known\u002Findexnow-key.txt` or similar\n2. Check if CMS has IndexNow plugin (WordPress: IndexNow plugin; many modern CMS platforms support it natively)\n3. If not implemented, recommend adding it with instructions\n\n---\n\n## Overall Scoring\n\n| Category | Max Points | Weight |\n|---|---|---|\n| Crawlability | 15 | Core foundation |\n| Indexability | 12 | Core foundation |\n| Security | 10 | Trust signal |\n| URL Structure | 8 | Crawl efficiency |\n| Mobile Optimization | 10 | Google requirement |\n| Core Web Vitals | 15 | Ranking signal |\n| Server-Side Rendering | 15 | GEO critical |\n| Page Speed & Server | 15 | Performance |\n| **Total** | **100** | |\n\nNon-scoring checks (Category 9) appear in the output under \"Agent-Readiness Signals\" and do not affect this total.\n\n### Score Interpretation\n- **90-100**: Excellent — technically sound for both traditional SEO and GEO\n- **70-89**: Good — minor issues to address but fundamentally solid\n- **50-69**: Needs Work — significant technical debt impacting visibility\n- **30-49**: Poor — major issues blocking crawling, indexing, or AI visibility\n- **0-29**: Critical — fundamental technical failures requiring immediate attention\n\n---\n\n## Output Format\n\nGenerate **GEO-TECHNICAL-AUDIT.md** with:\n\n```markdown\n# GEO Technical SEO Audit — [Domain]\nDate: [Date]\n\n## Technical Score: XX\u002F100\n\n## Score Breakdown\n| Category | Score | Status |\n|---|---|---|\n| Crawlability | XX\u002F15 | Pass\u002FWarn\u002FFail |\n| Indexability | XX\u002F12 | Pass\u002FWarn\u002FFail |\n| Security | XX\u002F10 | Pass\u002FWarn\u002FFail |\n| URL Structure | XX\u002F8 | Pass\u002FWarn\u002FFail |\n| Mobile Optimization | XX\u002F10 | Pass\u002FWarn\u002FFail |\n| Core Web Vitals | XX\u002F15 | Pass\u002FWarn\u002FFail |\n| Server-Side Rendering | XX\u002F15 | Pass\u002FWarn\u002FFail |\n| Page Speed & Server | XX\u002F15 | Pass\u002FWarn\u002FFail |\n\nStatus: Pass = 80%+ of category points, Warn = 50-79%, Fail = \u003C50%\n\n## AI Crawler Access\n| Crawler | User-Agent | Status | Recommendation |\n|---|---|---|---|\n| GPTBot | GPTBot | Allowed\u002FBlocked | [Action] |\n| Googlebot | Googlebot | Allowed\u002FBlocked | [Action] |\n[Continue for all AI crawlers]\n\n## Critical Issues (fix immediately)\n[List with specific page URLs and what is wrong]\n\n## Warnings (fix this month)\n[List with details]\n\n## Recommendations (optimize this quarter)\n[List with details]\n\n## Agent-Readiness Signals (non-scoring)\n\n### RFC 8288 Link Headers (Service Discovery)\n\n**Status:** Present \u002F Absent \u002F Not Applicable\n\n\u003C!-- If present: -->\n| Relation Type | URL | Meaning |\n|---|---|---|\n| api-catalog | \u002F.well-known\u002Fapi-catalog | Machine-readable index of available APIs |\n| mcp-server-card | \u002F.well-known\u002Fmcp.json | MCP server capability declaration |\n\nAI agents and API clients can discover your services without parsing HTML.\n\n\u003C!-- If absent, API-first site only: -->\n**Informational Recommendation:** This site has API\u002Fdeveloper-oriented content but no `Link:` headers advertising discoverable services.\n\nExample: `Link: \u003C\u002F.well-known\u002Fapi-catalog>; rel=\"api-catalog\"`\n\nRelevant for: sites with public APIs, OpenAPI docs, or MCP server integrations.\nReference: RFC 8288, RFC 9609.\n\n\u003C!-- If absent, standard business site: omit this section entirely -->\n\n### Markdown Content Negotiation\n\n**Status:** Supported \u002F Not Supported\n**Test:** GET [url] with `Accept: text\u002Fmarkdown`\n**Response Content-Type:** [value]\n\n\u003C!-- If supported: -->\nThis site serves clean Markdown to AI agents on request. AI crawlers that support content negotiation receive formatted text without HTML boilerplate.\n\n\u003C!-- If not supported: -->\n**Forward-Looking Recommendation:** Cloudflare Workers\u002FPages sites can enable Markdown content negotiation with a one-line configuration change. When an AI agent sends `Accept: text\u002Fmarkdown`, the server responds with clean Markdown instead of HTML.\n\n- Currently Cloudflare-specific\n- Relevant for: sites already on Cloudflare infrastructure\n- Other CDNs and frameworks expected to adopt this pattern as AI agent traffic grows\n\n## Detailed Findings\n[Per-category breakdown with evidence]\n```\n","# GEO Technical SEO Audit\n\n## Purpose\n\nTechnical SEO forms the foundation of both traditional search visibility and AI search citation. A technically broken site cannot be crawled, indexed, or cited by any platform. This skill audits 8 categories of technical health with specific attention to GEO requirements — most critically, **server-side rendering** (AI crawlers do not execute JavaScript) and **AI crawler access** (many sites inadvertently block AI crawlers in robots.txt).\n\n## How to Use This Skill\n\n1. Collect the target URL (homepage + 2-3 key inner pages)\n2. Fetch each page using curl\u002FWebFetch to get raw HTML and HTTP headers\n3. Run through each of the 8 audit categories below\n4. Score each category using the rubric\n5. Generate GEO-TECHNICAL-AUDIT.md with results\n\n---\n\n## Category 1: Crawlability (15 points)\n\n### 1.1 robots.txt Validity\n- Fetch `https:\u002F\u002F[domain]\u002Frobots.txt`\n- Check for syntactic validity: proper `User-agent`, `Allow`, `Disallow` directives\n- Check for common errors: missing User-agent, wildcards blocking important paths, Disallow: \u002F blocking entire site\n- Verify XML sitemap is referenced: `Sitemap: https:\u002F\u002F[domain]\u002Fsitemap.xml`\n\n### 1.2 AI Crawler Access (CRITICAL for GEO)\nCheck robots.txt for directives targeting these AI crawlers:\n\n| Crawler | User-Agent | Platform |\n|---|---|---|\n| GPTBot | GPTBot | ChatGPT \u002F OpenAI |\n| Google-Extended | Google-Extended | Gemini \u002F Google AI training |\n| Googlebot | Googlebot | Google Search + AI Overviews |\n| Bingbot | bingbot | Bing Copilot + ChatGPT (via Bing) |\n| PerplexityBot | PerplexityBot | Perplexity AI |\n| ClaudeBot | ClaudeBot | Anthropic Claude |\n| Amazonbot | Amazonbot | Alexa \u002F Amazon AI |\n| CCBot | CCBot | Common Crawl (used by many AI models) |\n| FacebookBot | FacebookExternalHit | Meta AI |\n| Bytespider | Bytespider | TikTok \u002F ByteDance AI |\n| Applebot-Extended | Applebot-Extended | Apple Intelligence |\n\n**Scoring for AI crawler access:**\n- All major AI crawlers allowed: 5 points\n- Some blocked but Googlebot + Bingbot allowed: 3 points\n- GPTBot or PerplexityBot blocked: 1 point (significant GEO impact)\n- Googlebot blocked: 0 points (fatal)\n\n**Important nuance**: Blocking Google-Extended does NOT block Googlebot. Google-Extended only controls AI training data usage, not search indexing. However, blocking Google-Extended may reduce presence in AI Overviews. Recommend allowing Google-Extended unless there is a specific data licensing concern.\n\n### 1.3 XML Sitemaps\n- Fetch sitemap (check robots.txt for location, or try `\u002Fsitemap.xml`, `\u002Fsitemap_index.xml`)\n- Validate XML syntax\n- Check for `\u003Clastmod>` dates (should be present and accurate)\n- Count URLs — compare to expected number of indexable pages\n- Check for sitemap index if large site (50,000+ URLs per sitemap max)\n- Verify all sitemap URLs return 200 status codes (sample check)\n\n### 1.4 Crawl Depth\n- Homepage = depth 0. Check that all important pages are reachable within **3 clicks** (depth 3)\n- Pages at depth 4+ receive significantly less crawl budget and are less likely to be cited by AI\n- Check internal linking: are key content pages linked from the homepage or main navigation?\n\n### 1.5 Noindex Management\n- Check for `\u003Cmeta name=\"robots\" content=\"noindex\">` on pages that SHOULD be indexed\n- Check for `X-Robots-Tag: noindex` HTTP headers\n- Common mistakes: noindex on paginated pages, category pages, or key landing pages\n\n**Category Scoring:**\n| Check | Points |\n|---|---|\n| robots.txt valid and complete | 3 |\n| AI crawlers allowed | 5 |\n| XML sitemap present and valid | 3 |\n| Crawl depth within 3 clicks | 2 |\n| No erroneous noindex directives | 2 |\n\n---\n\n## Category 2: Indexability (12 points)\n\n### 2.1 Canonical Tags\n- Every indexable page must have a `\u003Clink rel=\"canonical\" href=\"...\">` tag\n- Canonical must point to itself (self-referencing) for the authoritative version\n- Check for conflicting canonicals (canonical in HTML vs. HTTP header)\n- Check for canonical chains (A canonicals to B, B canonicals to C — should be A to C)\n\n### 2.2 Duplicate Content\n- Check for www vs. non-www (both should resolve, one should redirect)\n- Check for HTTP vs. HTTPS (HTTP should redirect to HTTPS)\n- Check for trailing slash consistency (pick one pattern and redirect the other)\n- Check for parameter-based duplicates (`?sort=price` creating duplicate pages)\n\n### 2.3 Pagination\n- If paginated content exists, check for `rel=\"next\"` \u002F `rel=\"prev\"` (note: Google ignores these as of 2019, but Bing still uses them)\n- Preferred: use `rel=\"canonical\"` on paginated pages pointing to a view-all page or the first page\n- Ensure paginated pages are not noindexed if they contain unique content\n\n### 2.4 Hreflang (international sites)\n- Check for `\u003Clink rel=\"alternate\" hreflang=\"xx\">` tags\n- Validate: reciprocal hreflang (if page A points to page B, B must point back to A)\n- Validate: x-default fallback exists\n- Check for language\u002Fregion code validity (ISO 639-1 \u002F ISO 3166-1)\n\n### 2.5 Index Bloat\n- Estimate number of indexed pages (check sitemap count, use `site:domain.com` estimate)\n- Compare indexed pages to actual valuable content pages\n- Flag if indexed pages significantly exceed content pages (index bloat from thin\u002Fduplicate\u002Fparameter pages)\n\n**Category Scoring:**\n| Check | Points |\n|---|---|\n| Canonical tags correct on all pages | 3 |\n| No duplicate content issues | 3 |\n| Pagination handled correctly | 2 |\n| Hreflang correct (if applicable) | 2 |\n| No index bloat | 2 |\n\n---\n\n## Category 3: Security (10 points)\n\n### 3.1 HTTPS Enforcement\n- Site must load over HTTPS\n- HTTP must redirect to HTTPS (301 redirect)\n- No mixed content warnings (HTTP resources on HTTPS pages)\n- SSL\u002FTLS certificate must be valid and not expired\n\n### 3.2 Security Headers\nCheck HTTP response headers for:\n\n| Header | Required Value | Purpose |\n|---|---|---|\n| `Strict-Transport-Security` | `max-age=31536000; includeSubDomains` | Forces HTTPS |\n| `Content-Security-Policy` | Appropriate policy | Prevents XSS |\n| `X-Content-Type-Options` | `nosniff` | Prevents MIME sniffing |\n| `X-Frame-Options` | `DENY` or `SAMEORIGIN` | Prevents clickjacking |\n| `Referrer-Policy` | `strict-origin-when-cross-origin` or stricter | Controls referrer data |\n| `Permissions-Policy` | Appropriate restrictions | Controls browser features |\n\n**Category Scoring:**\n| Check | Points |\n|---|---|\n| HTTPS enforced with valid cert | 4 |\n| HSTS header present | 2 |\n| X-Content-Type-Options | 1 |\n| X-Frame-Options | 1 |\n| Referrer-Policy | 1 |\n| Content-Security-Policy | 1 |\n\n---\n\n## Category 4: URL Structure (8 points)\n\n### 4.1 Clean URLs\n- URLs should be human-readable: `\u002Fblog\u002Fseo-guide` not `\u002Fblog?id=12345`\n- No session IDs in URLs\n- Lowercase only (no mixed case)\n- Hyphens for word separation (not underscores)\n- No special characters or encoded spaces\n\n### 4.2 Logical Hierarchy\n- URL path should reflect site architecture: `\u002Fcategory\u002Fsubcategory\u002Fpage`\n- Flat where appropriate — avoid unnecessarily deep nesting\n- Consistent pattern across the site\n\n### 4.3 Redirect Chains\n- Check for redirect chains (A redirects to B redirects to C)\n- Maximum 1 hop recommended (A redirects to C directly)\n- Check for redirect loops\n- All redirects should be 301 (permanent), not 302 (temporary), unless intentionally temporary\n\n### 4.4 Parameter Handling\n- URL parameters should not create duplicate indexable pages\n- Use canonical tags or `robots.txt` Disallow for parameter variations\n- Configure parameter handling in Google Search Console and Bing Webmaster Tools\n\n**Category Scoring:**\n| Check | Points |\n|---|---|\n| Clean, readable URLs | 2 |\n| Logical hierarchy | 2 |\n| No redirect chains (max 1 hop) | 2 |\n| Parameter handling configured | 2 |\n\n---\n\n## Category 5: Mobile Optimization (10 points)\n\n### Critical Context\nAs of **July 2024**, Google crawls ALL sites exclusively with mobile Googlebot. There is no desktop crawling. If your site does not work on mobile, it does not work for Google. Period.\n\n### 5.1 Responsive Design\n- Check for `\u003Cmeta name=\"viewport\" content=\"width=device-width, initial-scale=1\">`\n- Content must not require horizontal scrolling on mobile\n- No fixed-width layouts wider than viewport\n\n### 5.2 Tap Targets\n- Interactive elements (buttons, links) must be at least 48x48 CSS pixels\n- Minimum 8px spacing between tap targets\n- Check that navigation is usable on mobile\n\n### 5.3 Font Sizes\n- Base font size should be at least 16px\n- No text requiring zoom to read\n- Sufficient contrast ratio (WCAG AA: 4.5:1 for normal text, 3:1 for large text)\n\n### 5.4 Mobile Content Parity\n- All content visible on desktop must also be visible on mobile\n- No hidden content behind \"read more\" toggles that Googlebot cannot expand (though Google has improved at expanding these as of 2025)\n- Images and media must load on mobile\n\n**Category Scoring:**\n| Check | Points |\n|---|---|\n| Viewport meta tag correct | 3 |\n| Responsive layout (no horizontal scroll) | 3 |\n| Tap targets appropriately sized | 2 |\n| Font sizes legible | 2 |\n\n---\n\n## Category 6: Core Web Vitals (15 points)\n\n### 2026 Metrics and Thresholds\nCore Web Vitals use the **75th percentile** of real user data (field data) as the benchmark. Lab data is useful for debugging but field data determines the ranking signal.\n\n| Metric | Good | Needs Improvement | Poor | Notes |\n|---|---|---|---|---|\n| **LCP** (Largest Contentful Paint) | \u003C 2.5s | 2.5s - 4.0s | > 4.0s | Measures loading — time until largest visible element renders |\n| **INP** (Interaction to Next Paint) | \u003C 200ms | 200ms - 500ms | > 500ms | Replaced FID in March 2024. Measures ALL interactions, not just first |\n| **CLS** (Cumulative Layout Shift) | \u003C 0.1 | 0.1 - 0.25 | > 0.25 | Measures visual stability — unexpected layout movements |\n\n### How to Assess Without CrUX Data\nWhen real user data is unavailable, estimate from page characteristics:\n- **LCP**: Check largest above-fold element. Is it an image (check size\u002Fformat)? Is it text (check web font loading)? Server response time (TTFB)?\n- **INP**: Check for heavy JavaScript on page. Long tasks (>50ms) block interactivity. Check for third-party scripts.\n- **CLS**: Check for images without explicit width\u002Fheight. Check for dynamically inserted content above the fold. Check for web fonts causing layout shift (FOUT\u002FFOIT).\n\n### Common LCP Fixes\n1. Optimize hero images: WebP\u002FAVIF format, correct sizing, preload with `\u003Clink rel=\"preload\">`\n2. Reduce server response time (TTFB \u003C 800ms)\n3. Eliminate render-blocking CSS\u002FJS\n4. Preconnect to critical third-party origins\n\n### Common INP Fixes\n1. Break up long tasks (>50ms) into smaller chunks using `requestIdleCallback` or `scheduler.yield()`\n2. Reduce third-party JavaScript\n3. Use `content-visibility: auto` for off-screen content\n4. Debounce\u002Fthrottle event handlers\n\n### Common CLS Fixes\n1. Always include `width` and `height` attributes on images and videos\n2. Reserve space for ads and embeds with CSS `aspect-ratio` or explicit dimensions\n3. Use `font-display: swap` with size-adjusted fallback fonts\n4. Avoid inserting content above existing content after page load\n\n**Category Scoring:**\n| Check | Points |\n|---|---|\n| LCP \u003C 2.5s | 5 |\n| INP \u003C 200ms | 5 |\n| CLS \u003C 0.1 | 5 |\n\n---\n\n## Category 7: Server-Side Rendering (15 points) — CRITICAL FOR GEO\n\n### Why SSR Is Mandatory for AI Visibility\nAI crawlers (GPTBot, PerplexityBot, ClaudeBot, etc.) do **NOT execute JavaScript**. They fetch the raw HTML and parse it. If your content is rendered client-side by React, Vue, Angular, or any other JavaScript framework, AI crawlers see an empty page.\n\nEven Googlebot, which does execute JavaScript, deprioritizes JS-rendered content due to the additional crawl budget required. Google processes JS rendering in a separate \"rendering queue\" that can delay indexing by days or weeks.\n\n### Detection Method\n1. Fetch the page with curl (no JavaScript execution): `curl -s [URL]`\n2. Compare the raw HTML to the rendered DOM (via browser)\n3. If key content (headings, paragraphs, product info, article text) is MISSING from the curl output, the site relies on client-side rendering\n\n### What to Check\n- **Main content text**: Is the article body \u002F product description \u002F page content in the raw HTML?\n- **Headings**: Are H1, H2, H3 tags present in raw HTML?\n- **Navigation**: Is the main navigation server-rendered?\n- **Structured data**: Is JSON-LD in the raw HTML or injected by JavaScript?\n- **Meta tags**: Are title, description, canonical, OG tags in the raw HTML?\n- **Internal links**: Are navigation and content links in the raw HTML? (Critical for crawlability)\n\n### SSR Solutions to Recommend\n| Framework | SSR Solution |\n|---|---|\n| React | Next.js (SSR\u002FSSG), Remix, Gatsby (SSG) |\n| Vue | Nuxt.js (SSR\u002FSSG) |\n| Angular | Angular Universal |\n| Svelte | SvelteKit |\n| Generic | Prerender.io (prerendering service), Rendertron |\n\n### Scoring Detail\n- All key content server-rendered: 15 points\n- Main content server-rendered but some elements JS-only: 10 points\n- Critical content requires JS (product info, article text): 5 points\n- Entire page is client-rendered (empty body in raw HTML): 0 points\n\n**Category Scoring:**\n| Check | Points |\n|---|---|\n| Main content in raw HTML | 8 |\n| Meta tags + structured data in raw HTML | 4 |\n| Internal links in raw HTML | 3 |\n\n---\n\n## Category 8: Page Speed & Server Performance (15 points)\n\n### 8.1 Time to First Byte (TTFB)\n- Target: **\u003C 800ms** (ideally \u003C 200ms)\n- Measure with curl: `curl -o \u002Fdev\u002Fnull -s -w 'TTFB: %{time_starttransfer}s\\n' [URL]`\n- If TTFB > 800ms: check server location, caching, database queries, CDN usage\n\n### 8.2 Resource Optimization\n- Total page weight target: **\u003C 2MB** (critical pages \u003C 1MB)\n- Check for uncompressed resources (gzip\u002Fbrotli compression should be enabled)\n- Check for unminified CSS and JavaScript\n- Check for unused CSS\u002FJS (can represent 50%+ of downloaded bytes on many sites)\n\n### 8.3 Image Optimization\n- Check image formats: WebP or AVIF preferred over JPEG\u002FPNG\n- Check for oversized images (images larger than display size)\n- Check for lazy loading: images below fold should have `loading=\"lazy\"`\n- Check for explicit dimensions (width\u002Fheight attributes prevent CLS)\n- Above-fold images should NOT be lazy loaded (harms LCP)\n\n### 8.4 Code Splitting and Lazy Loading\n- JavaScript should be code-split so each page only loads what it needs\n- Check for large JavaScript bundles (> 200KB compressed is a warning, > 500KB is critical)\n- Third-party scripts should load asynchronously (`async` or `defer`)\n- Check for render-blocking resources in `\u003Chead>`\n\n### 8.5 Caching\n- Check `Cache-Control` headers on static resources (images, CSS, JS)\n- Static assets should have long cache times: `max-age=31536000` (1 year) with content-hashed filenames\n- HTML pages should have shorter cache or `no-cache` with validation (`ETag` or `Last-Modified`)\n\n### 8.6 CDN Usage\n- Check if static resources are served from a CDN (different domain or CDN-specific headers)\n- For global audience, CDN is critical for consistent performance\n- Check for CDN-specific headers: `CF-Ray` (Cloudflare), `X-Cache` (AWS CloudFront), `X-Served-By` (Fastly)\n\n**Category Scoring:**\n| Check | Points |\n|---|---|\n| TTFB \u003C 800ms | 3 |\n| Page weight \u003C 2MB | 2 |\n| Images optimized (format, size, lazy) | 3 |\n| JS bundles reasonable (\u003C 200KB compressed) | 2 |\n| Compression enabled (gzip\u002Fbrotli) | 2 |\n| Cache headers on static resources | 2 |\n| CDN in use | 1 |\n\n---\n\n## Category 9: Agent-Readiness Signals (non-scoring)\n\nThese checks surface emerging AI agent compatibility signals. None contribute to the numeric score — they produce a pass or a recommendation. The underlying standards are either IETF drafts or early-adoption features; penalizing absence would be unfair.\n\n### 9.1 RFC 8288 Link Headers (Service Discovery)\n\nRFC 8288 (Web Linking) defines the HTTP `Link:` response header. Servers can use it to advertise related resources — API catalog, service docs, MCP server card — in a machine-readable way, without HTML parsing.\n\n**How to check:** Capture all `Link:` response headers from the standard homepage fetch (no extra request).\n\n**What to look for:**\n- Parse `\u003Curl>; rel=\"relation-type\"` pairs.\n- High-value rel types: `api-catalog` (RFC 9609), `describedby`, `service-doc`, `mcp-server-card`.\n\n**When to surface a recommendation:** Only for API-first sites (API docs linked in nav, `\u002Fapi\u002F` or `\u002Fdevelopers\u002F` paths, swagger\u002FOpenAPI in sitemap). Omit this section entirely for standard business sites — absence is expected and not noteworthy.\n\n| State | Treatment |\n|---|---|\n| `Link:` headers present, known rel types | Informational — document what was found |\n| `Link:` headers present, unknown rel types | Informational — note and explain |\n| Absent, API-first site | Recommendation — explain and suggest implementation |\n| Absent, standard business site | Omit — do not surface |\n\n### 9.2 Markdown Content Negotiation\n\nChecks if the server responds to `Accept: text\u002Fmarkdown` with `Content-Type: text\u002Fmarkdown`. Cloudflare's \"Markdown for Agents\" feature enables this — AI agents receive clean Markdown instead of HTML, eliminating boilerplate stripping and improving content extraction accuracy.\n\n**How to check:** Send a GET to the homepage with `Accept: text\u002Fmarkdown`. This is one additional HTTP request per audit.\n\n**Evaluation:**\n- If response `Content-Type` is `text\u002Fmarkdown` (or `text\u002Fmarkdown; charset=utf-8`): pass — note as a leading-edge capability.\n- Otherwise: forward-looking recommendation, not a failure.\n- If the request errors or returns non-200: skip and note the error. Do not penalize.\n\n| State | Treatment |\n|---|---|\n| `text\u002Fmarkdown` returned | Bonus — note as a leading-edge capability |\n| Standard HTML returned | Forward-looking recommendation |\n| Request errors \u002F non-200 | Skip, note the error, do not penalize |\n\n---\n\n## IndexNow Protocol\n\n### What It Is\nIndexNow is an open protocol that allows websites to notify search engines instantly when content is created, updated, or deleted. Supported by Bing, Yandex, Seznam, and Naver. Google does NOT support IndexNow but monitors the protocol.\n\n### Why It Matters for GEO\nChatGPT uses Bing's index. Bing Copilot uses Bing's index. Faster Bing indexing means faster AI visibility on two major platforms.\n\n### Implementation Check\n1. Check for IndexNow key file: `https:\u002F\u002F[domain]\u002F.well-known\u002Findexnow-key.txt` or similar\n2. Check if CMS has IndexNow plugin (WordPress: IndexNow plugin; many modern CMS platforms support it natively)\n3. If not implemented, recommend adding it with instructions\n\n---\n\n## Overall Scoring\n\n| Category | Max Points | Weight |\n|---|---|---|\n| Crawlability | 15 | Core foundation |\n| Indexability | 12 | Core foundation |\n| Security | 10 | Trust signal |\n| URL Structure | 8 | Crawl efficiency |\n| Mobile Optimization | 10 | Google requirement |\n| Core Web Vitals | 15 | Ranking signal |\n| Server-Side Rendering | 15 | GEO critical |\n| Page Speed & Server | 15 | Performance |\n| **Total** | **100** | |\n\nNon-scoring checks (Category 9) appear in the output under \"Agent-Readiness Signals\" and do not affect this total.\n\n### Score Interpretation\n- **90-100**: Excellent — technically sound for both traditional SEO and GEO\n- **70-89**: Good — minor issues to address but fundamentally solid\n- **50-69**: Needs Work — significant technical debt impacting visibility\n- **30-49**: Poor — major issues blocking crawling, indexing, or AI visibility\n- **0-29**: Critical — fundamental technical failures requiring immediate attention\n\n---\n\n## Output Format\n\nGenerate **GEO-TECHNICAL-AUDIT.md** with:\n\n```markdown\n# GEO Technical SEO Audit — [Domain]\nDate: [Date]\n\n## Technical Score: XX\u002F100\n\n## Score Breakdown\n| Category | Score | Status |\n|---|---|---|\n| Crawlability | XX\u002F15 | Pass\u002FWarn\u002FFail |\n| Indexability | XX\u002F12 | Pass\u002FWarn\u002FFail |\n| Security | XX\u002F10 | Pass\u002FWarn\u002FFail |\n| URL Structure | XX\u002F8 | Pass\u002FWarn\u002FFail |\n| Mobile Optimization | XX\u002F10 | Pass\u002FWarn\u002FFail |\n| Core Web Vitals | XX\u002F15 | Pass\u002FWarn\u002FFail |\n| Server-Side Rendering | XX\u002F15 | Pass\u002FWarn\u002FFail |\n| Page Speed & Server | XX\u002F15 | Pass\u002FWarn\u002FFail |\n\nStatus: Pass = 80%+ of category points, Warn = 50-79%, Fail = \u003C50%\n\n## AI Crawler Access\n| Crawler | User-Agent | Status | Recommendation |\n|---|---|---|---|\n| GPTBot | GPTBot | Allowed\u002FBlocked | [Action] |\n| Googlebot | Googlebot | Allowed\u002FBlocked | [Action] |\n[Continue for all AI crawlers]\n\n## Critical Issues (fix immediately)\n[List with specific page URLs and what is wrong]\n\n## Warnings (fix this month)\n[List with details]\n\n## Recommendations (optimize this quarter)\n[List with details]\n\n## Agent-Readiness Signals (non-scoring)\n\n### RFC 8288 Link Headers (Service Discovery)\n\n**Status:** Present \u002F Absent \u002F Not Applicable\n\n\u003C!-- If present: -->\n| Relation Type | URL | Meaning |\n|---|---|---|\n| api-catalog | \u002F.well-known\u002Fapi-catalog | Machine-readable index of available APIs |\n| mcp-server-card | \u002F.well-known\u002Fmcp.json | MCP server capability declaration |\n\nAI agents and API clients can discover your services without parsing HTML.\n\n\u003C!-- If absent, API-first site only: -->\n**Informational Recommendation:** This site has API\u002Fdeveloper-oriented content but no `Link:` headers advertising discoverable services.\n\nExample: `Link: \u003C\u002F.well-known\u002Fapi-catalog>; rel=\"api-catalog\"`\n\nRelevant for: sites with public APIs, OpenAPI docs, or MCP server integrations.\nReference: RFC 8288, RFC 9609.\n\n\u003C!-- If absent, standard business site: omit this section entirely -->\n\n### Markdown Content Negotiation\n\n**Status:** Supported \u002F Not Supported\n**Test:** GET [url] with `Accept: text\u002Fmarkdown`\n**Response Content-Type:** [value]\n\n\u003C!-- If supported: -->\nThis site serves clean Markdown to AI agents on request. AI crawlers that support content negotiation receive formatted text without HTML boilerplate.\n\n\u003C!-- If not supported: -->\n**Forward-Looking Recommendation:** Cloudflare Workers\u002FPages sites can enable Markdown content negotiation with a one-line configuration change. When an AI agent sends `Accept: text\u002Fmarkdown`, the server responds with clean Markdown instead of HTML.\n\n- Currently Cloudflare-specific\n- Relevant for: sites already on Cloudflare infrastructure\n- Other CDNs and frameworks expected to adopt this pattern as AI agent traffic grows\n\n## Detailed Findings\n[Per-category breakdown with evidence]\n```\n",{"name":5,"tags":24,"author":32,"version":33,"description":7,"allowed-tools":34},[25,26,27,28,29,30,31],"geo","technical-seo","core-web-vitals","ssr","crawlability","security","performance","geo-seo-claude","1.0.0","Read, Grep, Glob, Bash, WebFetch, Write","main","ad108f7eb3f6764136d02fb875772ebb34f54078","upstreams\u002Fsource-c\u002Fskills\u002Fgeo-technical",2,"https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar\u002FMarketing-Agent-OS","https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar","iamwaqargulzar.com","2026-11-03 21:14:34",{"source":8,"skillName":5,"commands":44,"prompt":54,"zipAvailable":55},[45,48,51],{"tool":46,"command":47},"npx","npx skills add iamwaqargulzar\u002FMarketing-Agent-OS --skill geo-technical",{"tool":49,"command":50},"bunx","bunx skills add iamwaqargulzar\u002FMarketing-Agent-OS --skill geo-technical",{"tool":52,"command":53},"pnpm","pnpm dlx skills add iamwaqargulzar\u002FMarketing-Agent-OS --skill geo-technical","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar\u002FMarketing-Agent-OS\u002Fblob\u002Fmain\u002Fupstreams\u002Fsource-c\u002Fskills\u002Fgeo-technical\u002FSKILL.md",true,[],[58,65,72,79,86,93],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M7AG5VYEX7J2R2AAD54A7YT7","video","When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use when the user mentions 'video production,' 'AI video,' 'Remotion,' 'Hyperframes,' 'HeyGen,' 'Synthesia,' 'Veo,' 'Sora,' 'Runway,' 'Kling,' 'Seedance,' 'Hailuo,' 'MiniMax,' 'Pika,' 'Hunyuan,' 'Wan,' 'video generation,' 'AI avatar,' 'talking head video,' 'programmatic video,' 'video template,' 'explainer video,' 'product demo video,' 'record a product demo,' 'feature demo video,' 'in-app demo,' 'video pipeline,' 'copy this edit,' 'match this video style,' 'reverse-engineer this video,' 'edit like this reference,' or 'make me a video.' Use this for video creation, generation, and production workflows. For video content strategy and what to post, see social. For paid video ad creative, see ad-creative.","https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar\u002FMarketing-Agent-OS\u002Fblob\u002Fmain\u002Fupstreams\u002Fsource-d\u002Fskills\u002Fvideo\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M7AG5FMXWA33FQDNS9PS1TE6","social","When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter\u002FX, Instagram, TikTok, or Facebook, or wants to do social listening and engagement triage. Also use when the user mentions 'LinkedIn post,' 'Twitter thread,' 'social media,' 'content calendar,' 'social scheduling,' 'engagement,' 'viral content,' 'what should I post,' 'repurpose this content,' 'tweet ideas,' 'LinkedIn carousel,' 'social media strategy,' 'grow my following,' 'TikTok video,' 'Reels,' 'Shorts,' 'video script,' 'video hook,' 'short-form video,' 'create a reel,' 'social listening,' 'brand mentions,' 'competitor monitoring,' 'top posts to comment on,' 'find people asking for,' 'carousel,' 'slide-by-slide,' or 'document post.' Use this for social content, repurposing, scheduling, video scripts, and listening. Posts avoid AI tells like 'it's not X, it's Y' reveals and broetry. For broader content strategy, see content-strategy. For paid ads, see ad-creative. For earned media, see public-relations.","https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar\u002FMarketing-Agent-OS\u002Fblob\u002Fmain\u002Fupstreams\u002Fsource-d\u002Fskills\u002Fsocial\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M7AG559W96W3DGE31KXYY78S","sms","When the user wants to plan, build, or optimize SMS, MMS, or WhatsApp marketing — including welcome flows, abandoned cart texts, post-purchase, win-back, promotional sends, or transactional\u002Fauth SMS. Also use when the user mentions \"SMS marketing,\" \"text message campaigns,\" \"SMS sequence,\" \"SMS automation,\" \"abandoned cart text,\" \"post-purchase SMS,\" \"Klaviyo SMS,\" \"Postscript,\" \"Attentive,\" \"Twilio,\" \"A2P 10DLC,\" \"TCPA,\" \"SMS compliance,\" \"short code,\" \"toll-free SMS,\" \"MMS campaign,\" \"should I do SMS,\" \"SMS vs email,\" \"WhatsApp marketing,\" \"WhatsApp Business API,\" \"WhatsApp templates,\" or \"click-to-WhatsApp.\" For email sequences, see emails. For SMS copy framing, see copywriting. For opt-in popups that capture phone numbers, see popups.","https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar\u002FMarketing-Agent-OS\u002Fblob\u002Fmain\u002Fupstreams\u002Fsource-d\u002Fskills\u002Fsms\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M7AG4WJ9EDSECNTQN0FEAYCQ","site-architecture","When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking. Also use when the user mentions \"sitemap,\" \"site map,\" \"visual sitemap,\" \"site structure,\" \"page hierarchy,\" \"information architecture,\" \"IA,\" \"navigation design,\" \"URL structure,\" \"breadcrumbs,\" \"internal linking strategy,\" \"website planning,\" \"what pages do I need,\" \"how should I organize my site,\" \"site navigation,\" \"which website builder should I use,\" \"migrate my website,\" or \"add a blog to my existing site.\" Use this whenever someone is planning what pages a website should have, how they connect, and where to build them. NOT for XML sitemaps (that's technical SEO — see seo-audit). For SEO audits, see seo-audit. For structured data, see schema.","https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar\u002FMarketing-Agent-OS\u002Fblob\u002Fmain\u002Fupstreams\u002Fsource-d\u002Fskills\u002Fsite-architecture\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M7AG4MH58GRMSHC0TADAWQ69","signup","When the user wants to optimize signup, registration, account creation, or trial activation flows. Also use when the user mentions \"signup conversions,\" \"registration friction,\" \"signup form optimization,\" \"free trial signup,\" \"reduce signup dropoff,\" \"account creation flow,\" \"people aren't signing up,\" \"signup abandonment,\" \"trial conversion rate,\" \"nobody completes registration,\" \"too many steps to sign up,\" or \"simplify our signup.\" Use this whenever the user has a signup or registration flow that isn't performing. For post-signup onboarding, see onboarding. For lead capture forms (not account creation), see cro.","https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar\u002FMarketing-Agent-OS\u002Fblob\u002Fmain\u002Fupstreams\u002Fsource-d\u002Fskills\u002Fsignup\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M7AG4CGGH35KYDFHYSS1BQZ5","seo-audit","When the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions \"SEO audit,\" \"technical SEO,\" \"why am I not ranking,\" \"SEO issues,\" \"on-page SEO,\" \"meta tags review,\" \"SEO health check,\" \"my traffic dropped,\" \"lost rankings,\" \"not showing up in Google,\" \"site isn't ranking,\" \"Google update hit me,\" \"page speed,\" \"core web vitals,\" \"crawl errors,\" \"indexing issues,\" \"stuck on page 2,\" \"striking distance keywords,\" \"title tag rewrite,\" \"low CTR,\" \"local SEO,\" \"Google Business Profile,\" or \"map pack.\" Use this even if the user just says something vague like \"my SEO is bad\" or \"help with SEO\" — start with an audit. For building pages at scale to target keywords, see programmatic-seo. For adding structured data, see schema. For AI search optimization, see ai-seo.","https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar\u002FMarketing-Agent-OS\u002Fblob\u002Fmain\u002Fupstreams\u002Fsource-d\u002Fskills\u002Fseo-audit\u002FSKILL.md",[],[]]