claude/skills/ai-seo/SKILL.md
This skill MUST be invoked when the user says "ai seo", "seo analiz", "GEO audit", "site optimize", "AI arama optimizasyonu", "citability", "ai citation", "crawlers check", "llms.txt", "brand mentions", "structured data audit", "schema audit", "technical seo", "E-E-A-T", "ai visibility", "generative engine optimization", or any variation requesting website optimization for AI-powered search engines. Analyzes websites for AI search readiness across citability, crawler access, brand authority, structured data, technical foundations, and content quality.
npx skillsauth add kilimcininkoroglu/cli-tweaks ai-seoInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Optimize websites for AI-powered search engines (ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews) while maintaining traditional SEO foundations.
AI search is eating traditional search. This skill optimizes for where traffic is going, not where it was.
/ai-seo audit <url> # Full GEO + SEO audit with parallel analysis
/ai-seo citability <url> # AI citation readiness scoring
/ai-seo crawlers <url> # AI crawler access check (robots.txt)
/ai-seo llmstxt <url> # llms.txt analysis or generation
/ai-seo brands <url> # Brand mentions across AI-cited platforms
/ai-seo schema <url> # Structured data + entity recognition audit
/ai-seo technical <url> # Technical SEO foundations for AI
/ai-seo content <url> # Content quality + E-E-A-T assessment
| Signal | Impact | |--------|--------| | AI-referred traffic growth | +527% YoY | | AI traffic conversion vs organic | 4.4x higher | | Brand mentions vs backlinks for AI | 3x stronger correlation | | Gartner: search traffic drop by 2028 | -50% | | Sites with llms.txt | < 5% (early mover advantage) |
| Subcommand | Command | Description |
|--------------|------------------------------|-------------------------------------------------|
| audit | /ai-seo audit <url> | Full GEO audit with composite scoring |
| citability | /ai-seo citability <url> | Passage-level AI citation readiness |
| crawlers | /ai-seo crawlers <url> | AI crawler access analysis (robots.txt) |
| llmstxt | /ai-seo llmstxt <url> | llms.txt standard analysis or generation |
| brands | /ai-seo brands <url> | Brand authority on AI training platforms |
| schema | /ai-seo schema <url> | Structured data + entity recognition |
| technical | /ai-seo technical <url> | Technical SEO for AI crawlers |
| content | /ai-seo content <url> | Content quality + E-E-A-T scoring |
/ai-seo audit: see subcommands/audit.md/ai-seo citability: see subcommands/citability.md/ai-seo crawlers: see subcommands/crawlers.md/ai-seo llmstxt: see subcommands/llmstxt.md/ai-seo brands: see subcommands/brand-mentions.md/ai-seo schema: see subcommands/schema.md/ai-seo technical: see subcommands/technical.md/ai-seo content: see subcommands/content.mdThe full audit produces a weighted composite score (0-100):
| Category | Weight | Subcommand | |-----------------------------|--------|--------------| | AI Citability & Visibility | 25% | citability | | Brand Authority Signals | 20% | brands | | Content Quality & E-E-A-T | 20% | content | | Technical Foundations | 15% | technical | | Schema & Structured Data | 10% | schema | | Platform Optimization | 10% | crawlers + llmstxt |
Score interpretation:
| Range | Grade | Meaning | |-------|-------|---------| | 80-100 | A | AI-optimized — strong visibility in AI search | | 60-79 | B | Good foundation — targeted improvements needed | | 40-59 | C | Significant gaps — AI crawlers may struggle | | 20-39 | D | Major issues — minimal AI search presence | | 0-19 | F | Not optimized — invisible to AI search |
When running a full audit, detect the site type to adjust analysis focus:
| Type | Signals | Adjusted Focus | |------|---------|----------------| | SaaS | /pricing, /docs, /api, app subdomain | Documentation citability, API schema | | Local | Address, map embed, NAP data, reviews | LocalBusiness schema, Google Business | | E-commerce | /products, cart, price elements | Product schema, review markup | | Publisher | /blog, /articles, bylines, dates | Article schema, E-E-A-T, citability | | Agency | /services, /portfolio, /case-studies | Organization schema, brand authority |
All subcommands that need page content should use available tools:
Do NOT use Python scripts or external dependencies. The LLM's analysis capabilities replace regex-based scoring with context-aware, more accurate assessment.
All subcommands return analysis in the response as structured markdown. No files are created unless explicitly requested. Each analysis includes:
development
This skill MUST be invoked when the user says "version update skill oluştur", "create version update skill", "versiyon skill'i oluştur", "update-version skill", "version-update skill yap" or any variation requesting creation of a project-local version update skill. SHOULD also invoke when user mentions "versiyon güncelleme skill'i kur", "setup version bumping", or asks to automate version management for the current project. Scans the project for version files, build commands, and changelog, then generates a tailored version-update skill in .factory/skills/.
development
This skill MUST be invoked when the user says "task-plan", "görev planla", "break down this PRD", "create tasks from spec", "PRD'yi parçala", "görevleri oluştur" or any variation requesting task breakdown from a specification document. SHOULD also invoke when user mentions "feature breakdown", "sprint planning", "task tracking", or wants to manage a structured development workflow with features and tasks.
testing
This skill MUST be invoked when the user says "commit tarihlerini değiştir", "redate commits", "spread commits", "backdate" or any variation requesting git commit date rewriting across a date range. Rewrites both author and committer dates using git filter-branch, distributing commits realistically across the specified period.
development
This skill MUST be invoked when the user says "UIKit", "iOS geliştirme", "programmatic UI", "table view", "collection view", "Auto Layout", "UIViewController", "UINavigationController", "Core Animation", "UIKit review", "UIKit build", "iOS view controller", "UIKit pattern", "programmatic layout", or any variation requesting UIKit development, review, or improvement. Covers programmatic UIKit with Auto Layout, table/collection views, navigation, animation, networking, architecture, and 20 reference documents with production-ready patterns.