tools/skills/kimmo-geo-audit/SKILL.md
Audit websites for AI search visibility and Generative Engine Optimization (GEO). Use when auditing a website for LLM/AI search presence, checking how ChatGPT or Perplexity see a brand, or optimizing content for AI recommendations.
npx skillsauth add ihmissuti/kimmoihanus-nextjs-site kimmo-geo-auditInstall 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.
Audit any website or brand for visibility in AI search engines (ChatGPT, Perplexity, Claude, Gemini).
Ask the user for:
Use ai_optimization_llm_mentions_search with:
{
"target": [{ "domain": "target-domain.com" }],
"platform": "chat_gpt",
"language_code": "en"
}
Key metrics to extract:
Test these prompt patterns against ChatGPT/Perplexity:
Record for each:
Analyze the website for LLM-friendliness:
| Factor | Check | Why It Matters | | ---------------------- | ----------------------------------------- | ---------------------------- | | Schema.org markup | Present? Complete? | LLMs extract structured data | | Clear hierarchy | H1→H2→H3 structure | Helps LLM understand content | | Crawlable | No login walls, robots.txt allows AI bots | LLMs need access to index | | Code examples | Working, copy-pasteable | Critical for devtools | | Consistent terminology | Same terms throughout | Reduces LLM confusion |
Compare target vs competitors:
# GEO Audit: [Brand Name]
## Executive Summary
- **Overall AI Visibility Score**: [Low/Medium/High]
- **Primary Gap**: [One sentence summary]
- **Quick Win**: [Highest impact, lowest effort action]
## AI Search Presence
### LLM Mention Analysis
| Metric | Value | Benchmark |
| --------------- | ----------- | ----------------- |
| Total mentions | X | Competitor avg: Y |
| Citation rate | X% | Industry avg: Y% |
| Sentiment score | X% positive | Competitor: Y% |
### Query Performance
| Query Type | Mentioned? | Position | Sentiment |
| ---------- | ---------- | ----------- | ----------- |
| Category | ✅/❌ | 1st/2nd/etc | +/-/neutral |
| Comparison | ✅/❌ | - | - |
| Problem | ✅/❌ | - | - |
## Technical GEO Score
| Factor | Status | Action |
| ----------------- | ---------- | --------------------------------- |
| Schema.org | ⚠️ Partial | Add Organization, Product schemas |
| Content structure | ✅ Good | - |
| Crawlability | ❌ Issue | Allow AI bot crawlers |
## Recommendations (Priority Order)
1. **[Action]** - Expected impact: [High/Medium]
2. **[Action]** - Expected impact: [High/Medium]
3. **[Action]** - Expected impact: [Medium/Low]
## Competitive Positioning
[How target compares to competitors in AI visibility]
Call the public API for instant automated audits:
curl -X POST https://kimmoihanus.com/api/geo-audit \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com"}'
Returns: score, grade, schema analysis, recommendations, and strengths/gaps.
ai_optimization_llm_mentions_search - Brand mention analysisai_optimization_chat_gpt_scraper - Direct ChatGPT responsesai_optimization_llm_mentions_aggregated_metrics - Trend datascrape_as_markdown - Crawl competitor pagessearch_engine - Check traditional SERP presenceai_search - Web search with AI featuresai_scraper - Extract structured contentIf no MCP/API tools available, guide user to manually test queries in:
Traditional: Marketing → Landing page → Docs → Trial → Conversion
Agent: Problem → AI suggestion → npm install → Subscription
AI assistants recommend tools they can understand and use. If your service is hard for an AI to work with, it won't be recommended—regardless of how good your marketing is.
By Kimmo Ihanus | kimmoihanus.com
data-ai
Generate and optimize Schema.org structured data for AI/LLM visibility. Use when adding schema markup, improving structured data, or optimizing for rich results and AI search engines.
tools
Score developer tools and SaaS products for AI agent compatibility. Use when evaluating how well a devtool works with AI coding assistants, or when optimizing a product for the agent era.
documentation
Generate JSON-LD schema markup for GEO optimization. Use when creating structured data for articles, products, FAQs, how-to guides, organizations, and other content types to improve AI search visibility and rich results.
development
Next.js development conventions and patterns for kimmoihanus.com. Use when working on pages, components, or API routes in this project.