geo-fundamentals

Audit public web pages for GEO elements and produce per-page scores.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/Icebane84/Synarche_Workshop --skill geo-fundamentals-icebane84
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: geo-fundamentals
Source: https://github.com/Icebane84/Synarche_Workshop/tree/main/.agent/skills/design/geo-fundamentals
Command: npx skills add https://github.com/Icebane84/Synarche_Workshop --skill geo-fundamentals-icebane84

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It helps you audit and improve web pages so AI search engines can easily extract, trust, and cite your content in generated answers.

Core Features & Use Cases

  • GEO audit for citation readiness: Detects structured data (JSON-LD), heading structure, author attribution, publication dates, FAQ signals, lists/tables, entity/schema cues, and citation-friendly patterns like original statistics.
  • Targeted page scanning: Locates likely public web pages by analyzing HTML and app-style JSX/TSX content while skipping common non-public directories and config/test artifacts.
  • Actionable scoring and issue reporting: Produces per-page pass/issue signals and an overall average score so teams can prioritize fixes before publishing or marketing launches.
  • Use case: Before launching a product or knowledge base update, run the audit to identify missing JSON-LD, weak heading structure, or absent author/date/FAQ elements that reduce AI citation likelihood.

Quick Start

Run the GEO audit script on your project by executing python scripts/geo_checker.py <project_path> and review the scored output to see what to fix.

Frequently Asked Questions about geo-fundamentals

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

FAQPage Schema
How do I optimize web pages for AI search engine citations?

To optimize web pages for AI search engine citations, audit your content for GEO elements like JSON-LD structured data, heading structure, and author attribution to boost extractability and credibility signals for AI search engines.

What is GEO and how does it affect content visibility in ChatGPT and Perplexity?

GEO improves AI search engine citation readiness by auditing public web pages for extractability, credibility, and freshness signals so AI models like ChatGPT and Perplexity can easily parse and reference your content.

How do I audit my website for JSON-LD and structured data?

Run a GEO audit script on your project path to detect JSON-LD structured data, validate heading structure, check for author and date presence, and generate a per-page score indicating citation readiness.

Does adding FAQ sections and publication dates improve AI search citations?

Adding FAQ sections and publication dates improves AI search citations by providing scannable layout features and freshness signals that make content easier for AI search engines to extract and trust.

Can I scan app-style JSX and TSX files for GEO readiness?

Yes, the GEO audit locates likely public web pages by analyzing standard HTML alongside app-style JSX and TSX content while automatically skipping common non-public directories and config or test artifacts.