geo-fundamentals

Audits web pages for AI search engine citation readiness using GEO checks.

2|Updated May 30, 2026
One-click install
npx skills add https://github.com/virahitvin8/crafty-gis --skill geo-fundamentals-virahitvin8
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: geo-fundamentals
Source: https://github.com/virahitvin8/crafty-gis/tree/main/GIT_STAR/.agent/skills/geo-fundamentals
Command: npx skills add https://github.com/virahitvin8/crafty-gis --skill geo-fundamentals-virahitvin8

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Content optimized only for traditional SEO often fails to get cited by AI search engines like ChatGPT, Claude, and Perplexity, leaving brands invisible in AI-generated answers. ## Core Features & Use Cases - GEO Audit Script: Runs scripts/geo_checker.py to scan HTML, JSX, and TSX pages for JSON-LD structured data, heading structure, author attribution, publication dates, FAQ sections, and statistics. - AI Engine Guidance: Provides reference tables on how Perplexity, ChatGPT, Claude, and Gemini select and cite content, including RAG retrieval factors and AI crawler user-agents. - Content Checklists: Supplies actionable checklists for citable content elements, entity building, and measurement of AI citation rates. - Use Case: A marketing team runs the checker against their Next.js blog, discovers missing Article schema and author info, and fixes them to increase the chance of being cited in Perplexity answers. ## Quick Start Run the GEO checker script on my project folder and tell me which pages need structured data, author info, or FAQ sections to improve AI citation readiness.

Frequently Asked Questions about geo-fundamentals

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I optimize content for AI search engines like ChatGPT and Perplexity?

Generative Engine Optimization focuses on structured, citable content: add JSON-LD schema, clear H1/H2 headings, author attribution, publication dates, FAQ sections, and original statistics. Run the geo_checker.py script to audit pages for these elements.

What is the difference between SEO and GEO?

SEO targets keyword rankings and click-through rates on Google, while GEO targets citations inside AI-generated answers on engines like ChatGPT, Claude, and Perplexity. GEO emphasizes entities, structured data, and extractable answers over keyword density.

How do I check if my website is ready for AI citations?

Run `python scripts/geo_checker.py <project_path>` to scan HTML, JSX, and TSX pages. It reports a per-page and average GEO score based on structured data, headings, author info, dates, FAQs, and statistics, flagging pages scoring below 60%.

Does the GEO checker analyze markdown or documentation files?

No, the checker only analyzes public-facing web pages: HTML files and JSX/TSX page components in pages, app, or routes directories. It skips markdown, docs folders, tests, config files, and node_modules since those are not indexed by AI engines.

Should I block AI crawlers like GPTBot and PerplexityBot?

Allow AI crawlers if you want your content cited in AI answers; block GPTBot only if you want to prevent OpenAI training on your content. A selective robots.txt strategy lets you permit some engines while blocking others.