geo-schema
starsforks
How to install geo-schema?
zubair-trabzada/geo-seo-claude/geo-schema
$npx -y skills add zubair-trabzada/geo-seo-claude --skill geo-schemaSchema.org structured data audit and generation optimized for AI discoverability — detect, validate, and generate JSON-LD markup
SKILL.md
| 1 | # GEO Schema & Structured Data |
| 2 | |
| 3 | ## Purpose |
| 4 | |
| 5 | Structured data is the primary machine-readable signal that tells AI systems what an entity IS, what it does, and how it connects to other entities. While schema markup has traditionally been about earning Google rich results, its role in GEO is fundamentally different: **structured data is how AI models understand and trust your entity**. A complete entity graph in structured data dramatically increases citation probability across all AI search platforms. |
| 6 | |
| 7 | ## How to Use This Skill |
| 8 | |
| 9 | 1. Fetch the target page HTML using `fetch_page.py` (see note below) |
| 10 | 2. Detect all existing structured data (JSON-LD, Microdata, RDFa) |
| 11 | 3. Validate detected schemas against Schema.org specifications |
| 12 | 4. Identify missing recommended schemas based on business type |
| 13 | 5. Generate ready-to-use JSON-LD code blocks |
| 14 | 6. Output GEO-SCHEMA-REPORT.md |
| 15 | |
| 16 | --- |
| 17 | |
| 18 | ## Step 1: Detection |
| 19 | |
| 20 | **IMPORTANT:** WebFetch converts HTML to markdown and strips `<head>` content, which removes JSON-LD blocks. Use `fetch_page.py` instead: |
| 21 | ```bash |
| 22 | python3 ~/.claude/skills/geo/scripts/fetch_page.py <url> page |
| 23 | ``` |
| 24 | The output includes a `structured_data` array with all parsed JSON-LD blocks from the page. |
| 25 | |
| 26 | ### Scan for JSON-LD |
| 27 | Look for `<script type="application/ld+json">` blocks in the HTML. Parse each block as JSON. A page may contain multiple JSON-LD blocks — collect all of them. |
| 28 | |
| 29 | ### Scan for Microdata |
| 30 | Look for elements with `itemscope`, `itemtype`, and `itemprop` attributes. Map the hierarchy of nested items. Note: Microdata is harder for AI crawlers to parse than JSON-LD. Flag a recommendation to migrate to JSON-LD if Microdata is the only format found. |
| 31 | |
| 32 | ### Scan for RDFa |
| 33 | Look for elements with `typeof`, `property`, and `vocab` attributes. Similar to Microdata — recommend migration to JSON-LD. |
| 34 | |
| 35 | ### Priority Order |
| 36 | JSON-LD is the **strongly recommended format** for GEO. Google, Bing, and AI platforms all process JSON-LD most reliably. If the site uses Microdata or RDFa exclusively, flag this as a high-priority migration. |
| 37 | |
| 38 | --- |
| 39 | |
| 40 | ## Step 2: Validation |
| 41 | |
| 42 | For each detected schema block, validate: |
| 43 | |
| 44 | 1. **Valid JSON**: Is the JSON-LD syntactically valid? Check for trailing commas, unquoted keys, malformed strings. |
| 45 | 2. **Valid @type**: Does the `@type` match a recognized Schema.org type? Check against https://schema.org/docs/full.html. |
| 46 | 3. **Required Properties**: Does the schema include all required properties for its type? (See per-type requirements below.) |
| 47 | 4. **Recommended Properties**: Does the schema include recommended properties that increase AI discoverability? |
| 48 | 5. **sameAs Links**: Does the schema include `sameAs` properties linking to other platform presences? |
| 49 | 6. **URL Validity**: Do all URLs in the schema resolve (not 404)? |
| 50 | 7. **Nesting**: Is the schema properly nested (e.g., author inside Article, address inside Organization)? |
| 51 | 8. **Rendering Method**: Is the JSON-LD in the server-rendered HTML or injected via JavaScript? Per Google's December 2025 guidance, **JavaScript-injected structured data may face delayed processing**. Flag any schema that requires JS execution. |
| 52 | |
| 53 | --- |
| 54 | |
| 55 | ## Step 3: Schema Types for GEO |
| 56 | |
| 57 | ### Organization (CRITICAL — every business site) |
| 58 | Essential for entity recognition across all AI platforms. This is how AI models identify WHAT the business is. |
| 59 | |
| 60 | **Required properties:** |
| 61 | - `@type`: "Organization" (or subtype: Corporation, LocalBusiness, etc.) |
| 62 | - `name`: Official business name |
| 63 | - `url`: Official website URL |
| 64 | - `logo`: URL to logo image (ImageObject preferred) |
| 65 | |
| 66 | **Recommended properties for GEO:** |
| 67 | - `sameAs`: Array of ALL platform URLs (see sameAs strategy below) |
| 68 | - `description`: 1-2 sentence description of the organization |
| 69 | - `foundingDate`: ISO 8601 date |
| 70 | - `founder`: Person schema |
| 71 | - `address`: PostalAddress schema |
| 72 | - `contactPoint`: ContactPoint with telephone, email, contactType |
| 73 | - `areaServed`: Geographic area |
| 74 | - `numberOfEmployees`: QuantitativeValue |
| 75 | - `industry`: Text or DefinedTerm |
| 76 | - `award`: Array of awards received |
| 77 | - `knowsAbout`: Array of topics the organization is expert in (strong GEO signal) |
| 78 | |
| 79 | ### LocalBusiness (for businesses with physical locations) |
| 80 | Extends Organization. Critical for local AI search results and Google Gemini. |
| 81 | |
| 82 | **Additional required properties:** |
| 83 | - `address`: Full PostalAddress |
| 84 | - `telephone`: Phone number |
| 85 | - `openingHoursSpecification`: Operating hours |
| 86 | |
| 87 | **Recommended for GEO:** |
| 88 | - `geo`: GeoCoordinates (latitude, longitude) |
| 89 | - `priceRange`: Price indicator |
| 90 | - `aggregateRating`: AggregateRating schema |
| 91 | - `review`: Array of Review schemas |
| 92 | - `hasMap`: URL to Google Maps |
| 93 | |
| 94 | ### Article + Author (CRITICAL for publishers) |
| 95 | The Author schema is one of the stronges |
People who liked this also viewed
6 picksType
- seo-auditWhen the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tagSkillsJul 2026
- copywritingWhen the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user sSkillsJul 2026
- marketing-psychologyWhen the user wants to apply psychological principles, mental models, or behavioral science to marketing. Also use when the user mentions 'psychology,' 'mental models,' 'cognitive bias,' 'persuasion,'SkillsJul 2026
- content-strategyWhen the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions "content strategy," "what should I write about," "conSkillsJul 2026
- programmatic-seoWhen the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions "programmatic SEO," "template pages," "pages at scale," "directory pages," "location pSkillsJul 2026
- marketing-ideasWhen the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the user asks for 'marketing ideas,' 'growth ideas,' 'how to market,' 'marketing stratSkillsJul 2026
