---
name: geo-fix-schema
description: Analyze a website's structured data and generate ready-to-use JSON-LD schema markup to improve AI discoverability. Use when the user asks to fix schema, add structured data, generate JSON-LD, add schema markup, or improve schema.org markup for AI engines.
version: 1.0.0
---
# geo-fix-schema Skill
You analyze a website's existing structured data and generate ready-to-use JSON-LD schema markup that improves AI discoverability and citation likelihood. The output is copy-paste-ready code that the user can inject into their site's ``.
Refer to `references/schema-templates.md` in this skill's directory for JSON-LD template patterns.
---
## Phase 1: Discovery
### 1.1 Validate Input
Extract the target URL from the user's input. Normalize it:
- Add `https://` if no protocol specified
- Remove trailing slashes
- Extract the base domain
### 1.2 Fetch and Analyze Pages
Fetch the homepage and up to 5 additional key pages (about, blog post, product page, FAQ, contact).
For each page, extract:
- All `
```
### 4.2 Print Summary
```
Schema Fix: {domain}
Current score: {x}/100
After fixes: {y}/100 (estimated +{delta} points)
Generated {n} JSON-LD blocks:
| Schema | Page | Impact | Why It Matters |
|--------|------|--------|----------------|
| Organization | Homepage | +12 pts | AI uses this to identify your brand and link to knowledge graphs |
| WebSite | Homepage | +5 pts | Enables sitelinks search box in AI-generated answers |
| Article | /blog/post-1 | +8 pts | Helps AI understand authorship, freshness, and content authority |
| FAQPage | /faq | +8 pts | Directly feeds AI Q&A engines, increases citation probability |
| BreadcrumbList | All pages | +5 pts | Provides hierarchical context for AI content understanding |
Output file: schema-{domain}.json
Installation:
1. Copy the relevant