geo-schema

Audit and generate Schema.org JSON-LD structured data for AI search discoverability.

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/finedesignz/geo-seo-claude --skill geo-schema-finedesignz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: geo-schema
Source: https://github.com/finedesignz/geo-seo-claude/tree/main/skills/geo-schema
Command: npx skills add https://github.com/finedesignz/geo-seo-claude --skill geo-schema-finedesignz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Websites often lack complete or valid structured data, which prevents AI search platforms like ChatGPT, Perplexity, and Google AI Overviews from recognizing, trusting, and citing their entities. This Skill detects, validates, and generates Schema.org markup so AI systems can understand what a business or author is. ## Core Features & Use Cases - Structured Data Detection: Scans pages for JSON-LD, Microdata, and RDFa, flagging non-JSON-LD formats for migration. - Schema Validation: Checks JSON validity, Schema.org types, required and recommended properties, sameAs links, and server-side rendering. - JSON-LD Generation: Produces ready-to-paste JSON-LD blocks for Organization, Person, Article, Product, LocalBusiness, FAQPage, SoftwareApplication, and more, using the @graph pattern. - Use Case: Run an audit on a company homepage to discover its Organization schema lacks sameAs links and knowsAbout topics, then receive a complete corrected JSON-LD block plus a scored GEO-SCHEMA-REPORT.md. ## Quick Start Ask the AI to audit the structured data on https://example.com and generate any missing JSON-LD schemas.

Frequently Asked Questions about geo-schema

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

FAQPage Schema
How do I audit structured data on a website for AI search?▼

Fetch the page HTML with a script that preserves head content, then scan for JSON-LD, Microdata, and RDFa blocks. Validate each block for JSON syntax, Schema.org types, required properties, and sameAs links, then score the results against a rubric.

What schema types matter most for AI discoverability?▼

Organization or Person schema with sameAs links is the most critical, followed by business-type-specific schemas like Article with author details, Product, LocalBusiness, or SoftwareApplication. The knowsAbout property and speakable specification are also strong GEO signals.

Is JSON-LD better than Microdata for SEO and GEO?▼

JSON-LD is the strongly recommended format because Google, Bing, and AI platforms process it most reliably. If a site uses only Microdata or RDFa, migrating to JSON-LD should be flagged as a high-priority fix.

Does FAQPage schema still work after Google's 2023 changes?▼

Google restricts FAQ rich results to government and health sites, but FAQPage schema still serves GEO purposes. AI platforms parse FAQ structured data for question-answer extraction, so implementing it remains useful for AI readability.

Why does JavaScript-injected structured data cause problems?▼

Per Google's December 2025 guidance, JavaScript-injected structured data may face delayed processing compared to server-rendered markup. JSON-LD should be placed directly in the HTML head section rather than injected dynamically.