geo-fundamentals

Audit web pages for AI-citation readiness and output per-page GEO scores.

3|2|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/grasberg/sofia --skill geo-fundamentals-grasberg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: geo-fundamentals
Source: https://github.com/grasberg/sofia/tree/main/cmd/sofia/internal/onboard/antigravity-kit/.agent/skills/geo-fundamentals
Command: npx skills add https://github.com/grasberg/sofia --skill geo-fundamentals-grasberg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Public web content often lacks machine-readable signals that enable AI models to cite and understand it reliably. This Skill audits pages for AI-citation readiness and guides improvements.

Core Features & Use Cases

  • JSON-LD and entity schema checks to improve discoverability.
  • H1/H2 structure, author and date metadata, and FAQ presence for better AI extraction.
  • Per-page scoring and actionable recommendations to optimize content for AI citations.

Quick Start

Run the GEO checker on a project to assess AI citation readiness and generate per-page reports.

Frequently Asked Questions about geo-fundamentals

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

FAQPage Schema
How do I audit my web content for AI-citation readiness?

To audit content for AI-citation readiness, analyze public web pages for structured data like JSON-LD, H1/H2 headings, author and date metadata, and FAQ sections. This generates per-page scores and actionable recommendations to improve machine-readable signals.

What is GEO optimization and how does it improve AI citations?

GEO optimization improves AI citations by adding machine-readable signals like JSON-LD and entity schemas to web content. Auditing semantic cues and metadata ensures AI models can reliably extract, understand, and cite your public-facing pages.

How do I check if my web pages have valid JSON-LD and proper H1/H2 structure?

Check JSON-LD and H1/H2 structure by running an automated audit across your project's public-facing pages. The audit identifies missing structured data and heading hierarchy issues, then outputs a per-page score to guide deterministic improvements.

Do I need FAQ sections and author metadata for better AI search extraction?

FAQ sections and author metadata are needed for better AI search extraction because they provide clear semantic cues. Including these signals alongside dates and structured data helps AI models reliably parse and cite your content.

What is the best way to score and optimize structured data across a website?

The best way to score structured data across a website is to run an automated audit that evaluates JSON-LD, headings, and metadata. This generates an average GEO score and per-page recommendations to drive deterministic content improvements.

Why does my web content fail to get cited by AI models despite having good text?

Content fails to get cited by AI models when it lacks machine-readable signals like JSON-LD, proper H1/H2 structure, and author metadata. Without these structured data elements, AI models struggle to reliably extract and verify the content.