[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AFPF1TJ88EBZ1XDK42NQTD":3,"skill-same:01M7AFPF1TJ88EBZ1XDK42NQTD":56},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":34,"commitSha":35,"skillDirectory":36,"forksCount":37,"repositoryHtmlUrl":38,"repositoryHomepageUrl":6,"ownerHtmlUrl":39,"ownerBlogUrl":40,"ownerDescription":6,"updatedAt":41,"install":42,"resources":55},"01M7AFPF1TJ88EBZ1XDK42NQTD","geo-schema",null,"Schema.org structured data audit and generation optimized for AI discoverability — detect, validate, and generate JSON-LD markup","iamwaqargulzar\u002FMarketing-Agent-OS","iamwaqargulzar","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F96654715?v=4","01M7ACMBN0TACNXY53QYG8KDF6","Waqar Gulzar","01M7ACMBNP5ZX60H8CD3JK0633",8,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar\u002FMarketing-Agent-OS\u002Fblob\u002Fmain\u002Fupstreams\u002Fsource-c\u002Fskills\u002Fgeo-schema\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: geo-schema\ndescription: Schema.org structured data audit and generation optimized for AI discoverability — detect, validate, and generate JSON-LD markup\nversion: 1.0.0\nauthor: geo-seo-claude\ntags: [geo, schema, structured-data, json-ld, entity-recognition, ai-discoverability]\nallowed-tools: Read, Grep, Glob, Bash, WebFetch, Write\n---\n\n# GEO Schema & Structured Data\n\n## Purpose\n\nStructured 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.\n\n## How to Use This Skill\n\n1. Fetch the target page HTML using `fetch_page.py` (see note below)\n2. Detect all existing structured data (JSON-LD, Microdata, RDFa)\n3. Validate detected schemas against Schema.org specifications\n4. Identify missing recommended schemas based on business type\n5. Generate ready-to-use JSON-LD code blocks\n6. Output GEO-SCHEMA-REPORT.md\n\n---\n\n## Step 1: Detection\n\n**IMPORTANT:** WebFetch converts HTML to markdown and strips `\u003Chead>` content, which removes JSON-LD blocks. Use `fetch_page.py` instead:\n```bash\npython3 ~\u002F.claude\u002Fskills\u002Fgeo\u002Fscripts\u002Ffetch_page.py \u003Curl> page\n```\nThe output includes a `structured_data` array with all parsed JSON-LD blocks from the page.\n\n### Scan for JSON-LD\nLook for `\u003Cscript type=\"application\u002Fld+json\">` blocks in the HTML. Parse each block as JSON. A page may contain multiple JSON-LD blocks — collect all of them.\n\n### Scan for Microdata\nLook 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.\n\n### Scan for RDFa\nLook for elements with `typeof`, `property`, and `vocab` attributes. Similar to Microdata — recommend migration to JSON-LD.\n\n### Priority Order\nJSON-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.\n\n---\n\n## Step 2: Validation\n\nFor each detected schema block, validate:\n\n1. **Valid JSON**: Is the JSON-LD syntactically valid? Check for trailing commas, unquoted keys, malformed strings.\n2. **Valid @type**: Does the `@type` match a recognized Schema.org type? Check against https:\u002F\u002Fschema.org\u002Fdocs\u002Ffull.html.\n3. **Required Properties**: Does the schema include all required properties for its type? (See per-type requirements below.)\n4. **Recommended Properties**: Does the schema include recommended properties that increase AI discoverability?\n5. **sameAs Links**: Does the schema include `sameAs` properties linking to other platform presences?\n6. **URL Validity**: Do all URLs in the schema resolve (not 404)?\n7. **Nesting**: Is the schema properly nested (e.g., author inside Article, address inside Organization)?\n8. **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.\n\n---\n\n## Step 3: Schema Types for GEO\n\n### Organization (CRITICAL — every business site)\nEssential for entity recognition across all AI platforms. This is how AI models identify WHAT the business is.\n\n**Required properties:**\n- `@type`: \"Organization\" (or subtype: Corporation, LocalBusiness, etc.)\n- `name`: Official business name\n- `url`: Official website URL\n- `logo`: URL to logo image (ImageObject preferred)\n\n**Recommended properties for GEO:**\n- `sameAs`: Array of ALL platform URLs (see sameAs strategy below)\n- `description`: 1-2 sentence description of the organization\n- `foundingDate`: ISO 8601 date\n- `founder`: Person schema\n- `address`: PostalAddress schema\n- `contactPoint`: ContactPoint with telephone, email, contactType\n- `areaServed`: Geographic area\n- `numberOfEmployees`: QuantitativeValue\n- `industry`: Text or DefinedTerm\n- `award`: Array of awards received\n- `knowsAbout`: Array of topics the organization is expert in (strong GEO signal)\n\n### LocalBusiness (for businesses with physical locations)\nExtends Organization. Critical for local AI search results and Google Gemini.\n\n**Additional required properties:**\n- `address`: Full PostalAddress\n- `telephone`: Phone number\n- `openingHoursSpecification`: Operating hours\n\n**Recommended for GEO:**\n- `geo`: GeoCoordinates (latitude, longitude)\n- `priceRange`: Price indicator\n- `aggregateRating`: AggregateRating schema\n- `review`: Array of Review schemas\n- `hasMap`: URL to Google Maps\n\n### Article + Author (CRITICAL for publishers)\nThe Author schema is one of the strongest E-E-A-T signals for AI platforms.\n\n**Article required:**\n- `@type`: \"Article\" (or NewsArticle, BlogPosting, TechArticle)\n- `headline`: Article title\n- `datePublished`: ISO 8601\n- `dateModified`: ISO 8601 (critical for freshness signals)\n- `author`: Person or Organization schema\n- `publisher`: Organization schema with logo\n- `image`: Representative image\n\n**Author (Person) required for GEO:**\n- `name`: Full name\n- `url`: Author page URL on the site\n- `sameAs`: LinkedIn, Twitter, personal site, Google Scholar, ORCID\n- `jobTitle`: Professional title\n- `worksFor`: Organization schema\n- `knowsAbout`: Array of expertise areas\n- `alumniOf`: Educational institutions\n- `award`: Professional awards\n\n### Product (for e-commerce)\n**Required:**\n- `name`, `description`, `image`\n- `offers`: Offer with price, priceCurrency, availability\n- `brand`: Brand schema\n- `sku` or `gtin`\u002F`mpn`\n\n**Recommended for GEO:**\n- `aggregateRating`: AggregateRating\n- `review`: Array of individual reviews\n- `category`: Product category\n- `material`, `weight`, `width`, `height` (where applicable)\n\n### FAQPage\n**Status as of 2024**: Google restricts FAQ rich results to government and health sites. However, the FAQPage schema still serves GEO purposes — AI platforms parse FAQ structured data for question-answer extraction. Implement it for AI readability even though rich results may not appear.\n\n**Structure:**\n- `@type`: \"FAQPage\"\n- `mainEntity`: Array of Question schemas, each with `acceptedAnswer` containing an Answer schema\n\n### SoftwareApplication (for SaaS)\n**Required:**\n- `name`, `description`\n- `applicationCategory`: e.g., \"BusinessApplication\"\n- `operatingSystem`: Supported platforms\n- `offers`: Pricing\n\n**Recommended for GEO:**\n- `aggregateRating`: User ratings\n- `featureList`: Array of features (strong citation signal)\n- `screenshot`: Screenshots\n- `softwareVersion`: Current version\n- `releaseNotes`: Link to changelog\n\n### WebSite + SearchAction (for sitelinks search box)\n**Structure:**\n```json\n{\n  \"@type\": \"WebSite\",\n  \"name\": \"Site Name\",\n  \"url\": \"https:\u002F\u002Fexample.com\",\n  \"potentialAction\": {\n    \"@type\": \"SearchAction\",\n    \"target\": {\n      \"@type\": \"EntryPoint\",\n      \"urlTemplate\": \"https:\u002F\u002Fexample.com\u002Fsearch?q={search_term_string}\"\n    },\n    \"query-input\": \"required name=search_term_string\"\n  }\n}\n```\n\n### Person (standalone — for personal brands, authors, thought leaders)\nUse as a standalone schema on About\u002FBio pages. This builds the entity graph for individual expertise.\n\n**Required:** `name`, `url`\n**Recommended for GEO:** `sameAs`, `jobTitle`, `worksFor`, `knowsAbout`, `alumniOf`, `award`, `description`, `image`\n\n### speakable Property (for voice\u002FAI assistants)\nThe `speakable` property marks specific sections of content as particularly suitable for voice and AI assistant consumption. Add to Article or WebPage schemas.\n\n```json\n{\n  \"@type\": \"Article\",\n  \"speakable\": {\n    \"@type\": \"SpeakableSpecification\",\n    \"cssSelector\": [\".article-summary\", \".key-takeaway\"]\n  }\n}\n```\nThis signals to AI assistants which passages are the best candidates for citation or reading aloud.\n\n---\n\n## Step 4: Deprecated\u002FChanged Schemas to Flag\n\n| Schema | Status | Note |\n|---|---|---|\n| HowTo | Rich results deprecated Aug 2023 | Still useful for AI parsing, but do not promise rich results |\n| FAQPage | Restricted to govt\u002Fhealth Aug 2023 | Still useful for AI parsing (see above) |\n| SpecialAnnouncement | Deprecated 2023 | Was for COVID; remove if still present |\n| CourseInfo | Replaced by Course updates 2024 | Use updated Course schema properties |\n| VideoObject `contentUrl` | Changed behavior 2024 | Must point to actual video file, not page URL |\n| Review snippet | Stricter enforcement 2024 | Self-serving reviews on product pages may not display |\n\nFlag any deprecated schemas found and recommend replacements.\n\n---\n\n## Step 5: sameAs Strategy (CRITICAL for Entity Recognition)\n\nThe `sameAs` property is the single most important structured data property for GEO. It tells AI systems: \"This entity on my website is the SAME entity as these profiles elsewhere.\" This creates the entity graph that AI platforms use to verify, trust, and cite sources.\n\n### Recommended sameAs Links (in priority order)\n\n1. **Wikipedia article** — highest authority entity link\n2. **Wikidata item** — machine-readable entity identifier (e.g., `https:\u002F\u002Fwww.wikidata.org\u002Fwiki\u002FQ12345`)\n3. **LinkedIn** — company page or personal profile\n4. **YouTube** — channel URL\n5. **Twitter\u002FX** — profile URL\n6. **Facebook** — page URL\n7. **Crunchbase** — company profile (for startups\u002Ftech)\n8. **GitHub** — organization or personal profile (for tech)\n9. **Google Scholar** — author profile (for researchers\u002Facademics)\n10. **ORCID** — researcher identifier (for academics)\n11. **Instagram** — profile URL\n12. **Apple App Store \u002F Google Play** — app listings (for software)\n13. **BBB** — Better Business Bureau listing (for US businesses)\n14. **Industry directories** — relevant vertical directories\n\n### sameAs Audit Process\n1. Collect all known web presences for the entity\n2. Check that each URL resolves (not 404 or redirected)\n3. Verify the Organization\u002FPerson schema includes ALL of them\n4. Check that the information on each platform is consistent (name, description, founding date, etc.)\n5. Flag any platforms where the entity should have a presence but does not\n\n---\n\n## Step 6: JSON-LD Generation\n\nBased on the detected business type, generate ready-to-paste JSON-LD blocks. Always generate:\n\n1. **Organization or Person** (depending on entity type) — always\n2. **WebSite with SearchAction** — always for the homepage\n3. **Business-type-specific** — Article for publishers, Product for e-commerce, LocalBusiness for local, SoftwareApplication for SaaS\n4. **BreadcrumbList** — for any page deeper than homepage\n\n### Generation Rules\n- Use the `@graph` pattern to include multiple schemas in one JSON-LD block\n- All URLs must be absolute (not relative)\n- Include `@id` properties for cross-referencing between schemas\n- Use ISO 8601 for all dates\n- Include `speakable` on Article schemas with CSS selectors pointing to key content sections\n- Place JSON-LD in `\u003Chead>` section — NOT injected via JavaScript\n\n### Template: Organization with Full GEO Signals\n```json\n{\n  \"@context\": \"https:\u002F\u002Fschema.org\",\n  \"@type\": \"Organization\",\n  \"@id\": \"https:\u002F\u002Fexample.com\u002F#organization\",\n  \"name\": \"Company Name\",\n  \"url\": \"https:\u002F\u002Fexample.com\",\n  \"logo\": {\n    \"@type\": \"ImageObject\",\n    \"url\": \"https:\u002F\u002Fexample.com\u002Flogo.png\",\n    \"width\": 600,\n    \"height\": 60\n  },\n  \"description\": \"Concise description of what the company does.\",\n  \"foundingDate\": \"2020-01-15\",\n  \"founder\": {\n    \"@type\": \"Person\",\n    \"name\": \"Founder Name\",\n    \"sameAs\": \"https:\u002F\u002Fwww.linkedin.com\u002Fin\u002Ffounder\"\n  },\n  \"address\": {\n    \"@type\": \"PostalAddress\",\n    \"streetAddress\": \"123 Main St\",\n    \"addressLocality\": \"City\",\n    \"addressRegion\": \"State\",\n    \"postalCode\": \"12345\",\n    \"addressCountry\": \"US\"\n  },\n  \"contactPoint\": {\n    \"@type\": \"ContactPoint\",\n    \"telephone\": \"+1-555-555-5555\",\n    \"contactType\": \"customer service\",\n    \"email\": \"support@example.com\"\n  },\n  \"sameAs\": [\n    \"https:\u002F\u002Fen.wikipedia.org\u002Fwiki\u002FCompany_Name\",\n    \"https:\u002F\u002Fwww.wikidata.org\u002Fwiki\u002FQ12345\",\n    \"https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Fcompany-name\",\n    \"https:\u002F\u002Fwww.youtube.com\u002F@companyname\",\n    \"https:\u002F\u002Ftwitter.com\u002Fcompanyname\",\n    \"https:\u002F\u002Fgithub.com\u002Fcompanyname\",\n    \"https:\u002F\u002Fwww.crunchbase.com\u002Forganization\u002Fcompany-name\"\n  ],\n  \"knowsAbout\": [\n    \"Topic 1\",\n    \"Topic 2\",\n    \"Topic 3\"\n  ]\n}\n```\n\n---\n\n## Scoring Rubric (0-100)\n\n| Criterion | Points | How to Score |\n|---|---|---|\n| Organization\u002FPerson schema present and complete | 15 | 15 if full, 10 if basic, 0 if none |\n| sameAs links (5+ platforms) | 15 | 3 per valid sameAs link, max 15 |\n| Article schema with author details | 10 | 10 if full author schema, 5 if name only, 0 if none |\n| Business-type-specific schema present | 10 | 10 if complete, 5 if partial, 0 if missing |\n| WebSite + SearchAction | 5 | 5 if present, 0 if not |\n| BreadcrumbList on inner pages | 5 | 5 if present, 0 if not |\n| JSON-LD format (not Microdata\u002FRDFa) | 5 | 5 if JSON-LD, 3 if mixed, 0 if only Microdata\u002FRDFa |\n| Server-rendered (not JS-injected) | 10 | 10 if in HTML source, 5 if JS but in head, 0 if dynamic JS |\n| speakable property on articles | 5 | 5 if present, 0 if not |\n| Valid JSON + valid Schema.org types | 10 | 10 if no errors, 5 if minor issues, 0 if major errors |\n| knowsAbout property on Organization\u002FPerson | 5 | 5 if present with 3+ topics, 0 if missing |\n| No deprecated schemas present | 5 | 5 if clean, 0 if deprecated schemas found |\n\n---\n\n## Output Format\n\nGenerate **GEO-SCHEMA-REPORT.md** with:\n\n```markdown\n# GEO Schema & Structured Data Report — [Domain]\nDate: [Date]\n\n## Schema Score: XX\u002F100\n\n## Detected Schemas\n| Page | Schema Type | Format | Status | Issues |\n|---|---|---|---|---|\n| \u002F | Organization | JSON-LD | Valid | Missing sameAs |\n| \u002Fblog\u002Fpost-1 | Article | JSON-LD | Valid | No author schema |\n\n## Validation Results\n[List each schema with pass\u002Ffail per property]\n\n## Missing Recommended Schemas\n[List schemas that should be present based on business type but are not]\n\n## sameAs Audit\n| Platform | URL | Status |\n|---|---|---|\n| Wikipedia | [URL or \"Not found\"] | Present\u002FMissing |\n| LinkedIn | [URL or \"Not found\"] | Present\u002FMissing |\n[Continue for all recommended platforms]\n\n## Generated JSON-LD Code\n[Ready-to-paste JSON-LD blocks for each missing or incomplete schema]\n\n## Implementation Notes\n- Where to place each JSON-LD block\n- Server-rendering requirements\n- Testing with Google Rich Results Test and Schema.org Validator\n```\n","# GEO Schema & Structured Data\n\n## Purpose\n\nStructured 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.\n\n## How to Use This Skill\n\n1. Fetch the target page HTML using `fetch_page.py` (see note below)\n2. Detect all existing structured data (JSON-LD, Microdata, RDFa)\n3. Validate detected schemas against Schema.org specifications\n4. Identify missing recommended schemas based on business type\n5. Generate ready-to-use JSON-LD code blocks\n6. Output GEO-SCHEMA-REPORT.md\n\n---\n\n## Step 1: Detection\n\n**IMPORTANT:** WebFetch converts HTML to markdown and strips `\u003Chead>` content, which removes JSON-LD blocks. Use `fetch_page.py` instead:\n```bash\npython3 ~\u002F.claude\u002Fskills\u002Fgeo\u002Fscripts\u002Ffetch_page.py \u003Curl> page\n```\nThe output includes a `structured_data` array with all parsed JSON-LD blocks from the page.\n\n### Scan for JSON-LD\nLook for `\u003Cscript type=\"application\u002Fld+json\">` blocks in the HTML. Parse each block as JSON. A page may contain multiple JSON-LD blocks — collect all of them.\n\n### Scan for Microdata\nLook 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.\n\n### Scan for RDFa\nLook for elements with `typeof`, `property`, and `vocab` attributes. Similar to Microdata — recommend migration to JSON-LD.\n\n### Priority Order\nJSON-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.\n\n---\n\n## Step 2: Validation\n\nFor each detected schema block, validate:\n\n1. **Valid JSON**: Is the JSON-LD syntactically valid? Check for trailing commas, unquoted keys, malformed strings.\n2. **Valid @type**: Does the `@type` match a recognized Schema.org type? Check against https:\u002F\u002Fschema.org\u002Fdocs\u002Ffull.html.\n3. **Required Properties**: Does the schema include all required properties for its type? (See per-type requirements below.)\n4. **Recommended Properties**: Does the schema include recommended properties that increase AI discoverability?\n5. **sameAs Links**: Does the schema include `sameAs` properties linking to other platform presences?\n6. **URL Validity**: Do all URLs in the schema resolve (not 404)?\n7. **Nesting**: Is the schema properly nested (e.g., author inside Article, address inside Organization)?\n8. **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.\n\n---\n\n## Step 3: Schema Types for GEO\n\n### Organization (CRITICAL — every business site)\nEssential for entity recognition across all AI platforms. This is how AI models identify WHAT the business is.\n\n**Required properties:**\n- `@type`: \"Organization\" (or subtype: Corporation, LocalBusiness, etc.)\n- `name`: Official business name\n- `url`: Official website URL\n- `logo`: URL to logo image (ImageObject preferred)\n\n**Recommended properties for GEO:**\n- `sameAs`: Array of ALL platform URLs (see sameAs strategy below)\n- `description`: 1-2 sentence description of the organization\n- `foundingDate`: ISO 8601 date\n- `founder`: Person schema\n- `address`: PostalAddress schema\n- `contactPoint`: ContactPoint with telephone, email, contactType\n- `areaServed`: Geographic area\n- `numberOfEmployees`: QuantitativeValue\n- `industry`: Text or DefinedTerm\n- `award`: Array of awards received\n- `knowsAbout`: Array of topics the organization is expert in (strong GEO signal)\n\n### LocalBusiness (for businesses with physical locations)\nExtends Organization. Critical for local AI search results and Google Gemini.\n\n**Additional required properties:**\n- `address`: Full PostalAddress\n- `telephone`: Phone number\n- `openingHoursSpecification`: Operating hours\n\n**Recommended for GEO:**\n- `geo`: GeoCoordinates (latitude, longitude)\n- `priceRange`: Price indicator\n- `aggregateRating`: AggregateRating schema\n- `review`: Array of Review schemas\n- `hasMap`: URL to Google Maps\n\n### Article + Author (CRITICAL for publishers)\nThe Author schema is one of the strongest E-E-A-T signals for AI platforms.\n\n**Article required:**\n- `@type`: \"Article\" (or NewsArticle, BlogPosting, TechArticle)\n- `headline`: Article title\n- `datePublished`: ISO 8601\n- `dateModified`: ISO 8601 (critical for freshness signals)\n- `author`: Person or Organization schema\n- `publisher`: Organization schema with logo\n- `image`: Representative image\n\n**Author (Person) required for GEO:**\n- `name`: Full name\n- `url`: Author page URL on the site\n- `sameAs`: LinkedIn, Twitter, personal site, Google Scholar, ORCID\n- `jobTitle`: Professional title\n- `worksFor`: Organization schema\n- `knowsAbout`: Array of expertise areas\n- `alumniOf`: Educational institutions\n- `award`: Professional awards\n\n### Product (for e-commerce)\n**Required:**\n- `name`, `description`, `image`\n- `offers`: Offer with price, priceCurrency, availability\n- `brand`: Brand schema\n- `sku` or `gtin`\u002F`mpn`\n\n**Recommended for GEO:**\n- `aggregateRating`: AggregateRating\n- `review`: Array of individual reviews\n- `category`: Product category\n- `material`, `weight`, `width`, `height` (where applicable)\n\n### FAQPage\n**Status as of 2024**: Google restricts FAQ rich results to government and health sites. However, the FAQPage schema still serves GEO purposes — AI platforms parse FAQ structured data for question-answer extraction. Implement it for AI readability even though rich results may not appear.\n\n**Structure:**\n- `@type`: \"FAQPage\"\n- `mainEntity`: Array of Question schemas, each with `acceptedAnswer` containing an Answer schema\n\n### SoftwareApplication (for SaaS)\n**Required:**\n- `name`, `description`\n- `applicationCategory`: e.g., \"BusinessApplication\"\n- `operatingSystem`: Supported platforms\n- `offers`: Pricing\n\n**Recommended for GEO:**\n- `aggregateRating`: User ratings\n- `featureList`: Array of features (strong citation signal)\n- `screenshot`: Screenshots\n- `softwareVersion`: Current version\n- `releaseNotes`: Link to changelog\n\n### WebSite + SearchAction (for sitelinks search box)\n**Structure:**\n```json\n{\n  \"@type\": \"WebSite\",\n  \"name\": \"Site Name\",\n  \"url\": \"https:\u002F\u002Fexample.com\",\n  \"potentialAction\": {\n    \"@type\": \"SearchAction\",\n    \"target\": {\n      \"@type\": \"EntryPoint\",\n      \"urlTemplate\": \"https:\u002F\u002Fexample.com\u002Fsearch?q={search_term_string}\"\n    },\n    \"query-input\": \"required name=search_term_string\"\n  }\n}\n```\n\n### Person (standalone — for personal brands, authors, thought leaders)\nUse as a standalone schema on About\u002FBio pages. This builds the entity graph for individual expertise.\n\n**Required:** `name`, `url`\n**Recommended for GEO:** `sameAs`, `jobTitle`, `worksFor`, `knowsAbout`, `alumniOf`, `award`, `description`, `image`\n\n### speakable Property (for voice\u002FAI assistants)\nThe `speakable` property marks specific sections of content as particularly suitable for voice and AI assistant consumption. Add to Article or WebPage schemas.\n\n```json\n{\n  \"@type\": \"Article\",\n  \"speakable\": {\n    \"@type\": \"SpeakableSpecification\",\n    \"cssSelector\": [\".article-summary\", \".key-takeaway\"]\n  }\n}\n```\nThis signals to AI assistants which passages are the best candidates for citation or reading aloud.\n\n---\n\n## Step 4: Deprecated\u002FChanged Schemas to Flag\n\n| Schema | Status | Note |\n|---|---|---|\n| HowTo | Rich results deprecated Aug 2023 | Still useful for AI parsing, but do not promise rich results |\n| FAQPage | Restricted to govt\u002Fhealth Aug 2023 | Still useful for AI parsing (see above) |\n| SpecialAnnouncement | Deprecated 2023 | Was for COVID; remove if still present |\n| CourseInfo | Replaced by Course updates 2024 | Use updated Course schema properties |\n| VideoObject `contentUrl` | Changed behavior 2024 | Must point to actual video file, not page URL |\n| Review snippet | Stricter enforcement 2024 | Self-serving reviews on product pages may not display |\n\nFlag any deprecated schemas found and recommend replacements.\n\n---\n\n## Step 5: sameAs Strategy (CRITICAL for Entity Recognition)\n\nThe `sameAs` property is the single most important structured data property for GEO. It tells AI systems: \"This entity on my website is the SAME entity as these profiles elsewhere.\" This creates the entity graph that AI platforms use to verify, trust, and cite sources.\n\n### Recommended sameAs Links (in priority order)\n\n1. **Wikipedia article** — highest authority entity link\n2. **Wikidata item** — machine-readable entity identifier (e.g., `https:\u002F\u002Fwww.wikidata.org\u002Fwiki\u002FQ12345`)\n3. **LinkedIn** — company page or personal profile\n4. **YouTube** — channel URL\n5. **Twitter\u002FX** — profile URL\n6. **Facebook** — page URL\n7. **Crunchbase** — company profile (for startups\u002Ftech)\n8. **GitHub** — organization or personal profile (for tech)\n9. **Google Scholar** — author profile (for researchers\u002Facademics)\n10. **ORCID** — researcher identifier (for academics)\n11. **Instagram** — profile URL\n12. **Apple App Store \u002F Google Play** — app listings (for software)\n13. **BBB** — Better Business Bureau listing (for US businesses)\n14. **Industry directories** — relevant vertical directories\n\n### sameAs Audit Process\n1. Collect all known web presences for the entity\n2. Check that each URL resolves (not 404 or redirected)\n3. Verify the Organization\u002FPerson schema includes ALL of them\n4. Check that the information on each platform is consistent (name, description, founding date, etc.)\n5. Flag any platforms where the entity should have a presence but does not\n\n---\n\n## Step 6: JSON-LD Generation\n\nBased on the detected business type, generate ready-to-paste JSON-LD blocks. Always generate:\n\n1. **Organization or Person** (depending on entity type) — always\n2. **WebSite with SearchAction** — always for the homepage\n3. **Business-type-specific** — Article for publishers, Product for e-commerce, LocalBusiness for local, SoftwareApplication for SaaS\n4. **BreadcrumbList** — for any page deeper than homepage\n\n### Generation Rules\n- Use the `@graph` pattern to include multiple schemas in one JSON-LD block\n- All URLs must be absolute (not relative)\n- Include `@id` properties for cross-referencing between schemas\n- Use ISO 8601 for all dates\n- Include `speakable` on Article schemas with CSS selectors pointing to key content sections\n- Place JSON-LD in `\u003Chead>` section — NOT injected via JavaScript\n\n### Template: Organization with Full GEO Signals\n```json\n{\n  \"@context\": \"https:\u002F\u002Fschema.org\",\n  \"@type\": \"Organization\",\n  \"@id\": \"https:\u002F\u002Fexample.com\u002F#organization\",\n  \"name\": \"Company Name\",\n  \"url\": \"https:\u002F\u002Fexample.com\",\n  \"logo\": {\n    \"@type\": \"ImageObject\",\n    \"url\": \"https:\u002F\u002Fexample.com\u002Flogo.png\",\n    \"width\": 600,\n    \"height\": 60\n  },\n  \"description\": \"Concise description of what the company does.\",\n  \"foundingDate\": \"2020-01-15\",\n  \"founder\": {\n    \"@type\": \"Person\",\n    \"name\": \"Founder Name\",\n    \"sameAs\": \"https:\u002F\u002Fwww.linkedin.com\u002Fin\u002Ffounder\"\n  },\n  \"address\": {\n    \"@type\": \"PostalAddress\",\n    \"streetAddress\": \"123 Main St\",\n    \"addressLocality\": \"City\",\n    \"addressRegion\": \"State\",\n    \"postalCode\": \"12345\",\n    \"addressCountry\": \"US\"\n  },\n  \"contactPoint\": {\n    \"@type\": \"ContactPoint\",\n    \"telephone\": \"+1-555-555-5555\",\n    \"contactType\": \"customer service\",\n    \"email\": \"support@example.com\"\n  },\n  \"sameAs\": [\n    \"https:\u002F\u002Fen.wikipedia.org\u002Fwiki\u002FCompany_Name\",\n    \"https:\u002F\u002Fwww.wikidata.org\u002Fwiki\u002FQ12345\",\n    \"https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Fcompany-name\",\n    \"https:\u002F\u002Fwww.youtube.com\u002F@companyname\",\n    \"https:\u002F\u002Ftwitter.com\u002Fcompanyname\",\n    \"https:\u002F\u002Fgithub.com\u002Fcompanyname\",\n    \"https:\u002F\u002Fwww.crunchbase.com\u002Forganization\u002Fcompany-name\"\n  ],\n  \"knowsAbout\": [\n    \"Topic 1\",\n    \"Topic 2\",\n    \"Topic 3\"\n  ]\n}\n```\n\n---\n\n## Scoring Rubric (0-100)\n\n| Criterion | Points | How to Score |\n|---|---|---|\n| Organization\u002FPerson schema present and complete | 15 | 15 if full, 10 if basic, 0 if none |\n| sameAs links (5+ platforms) | 15 | 3 per valid sameAs link, max 15 |\n| Article schema with author details | 10 | 10 if full author schema, 5 if name only, 0 if none |\n| Business-type-specific schema present | 10 | 10 if complete, 5 if partial, 0 if missing |\n| WebSite + SearchAction | 5 | 5 if present, 0 if not |\n| BreadcrumbList on inner pages | 5 | 5 if present, 0 if not |\n| JSON-LD format (not Microdata\u002FRDFa) | 5 | 5 if JSON-LD, 3 if mixed, 0 if only Microdata\u002FRDFa |\n| Server-rendered (not JS-injected) | 10 | 10 if in HTML source, 5 if JS but in head, 0 if dynamic JS |\n| speakable property on articles | 5 | 5 if present, 0 if not |\n| Valid JSON + valid Schema.org types | 10 | 10 if no errors, 5 if minor issues, 0 if major errors |\n| knowsAbout property on Organization\u002FPerson | 5 | 5 if present with 3+ topics, 0 if missing |\n| No deprecated schemas present | 5 | 5 if clean, 0 if deprecated schemas found |\n\n---\n\n## Output Format\n\nGenerate **GEO-SCHEMA-REPORT.md** with:\n\n```markdown\n# GEO Schema & Structured Data Report — [Domain]\nDate: [Date]\n\n## Schema Score: XX\u002F100\n\n## Detected Schemas\n| Page | Schema Type | Format | Status | Issues |\n|---|---|---|---|---|\n| \u002F | Organization | JSON-LD | Valid | Missing sameAs |\n| \u002Fblog\u002Fpost-1 | Article | JSON-LD | Valid | No author schema |\n\n## Validation Results\n[List each schema with pass\u002Ffail per property]\n\n## Missing Recommended Schemas\n[List schemas that should be present based on business type but are not]\n\n## sameAs Audit\n| Platform | URL | Status |\n|---|---|---|\n| Wikipedia | [URL or \"Not found\"] | Present\u002FMissing |\n| LinkedIn | [URL or \"Not found\"] | Present\u002FMissing |\n[Continue for all recommended platforms]\n\n## Generated JSON-LD Code\n[Ready-to-paste JSON-LD blocks for each missing or incomplete schema]\n\n## Implementation Notes\n- Where to place each JSON-LD block\n- Server-rendering requirements\n- Testing with Google Rich Results Test and Schema.org Validator\n```\n",{"name":5,"tags":24,"author":31,"version":32,"description":7,"allowed-tools":33},[25,26,27,28,29,30],"geo","schema","structured-data","json-ld","entity-recognition","ai-discoverability","geo-seo-claude","1.0.0","Read, Grep, Glob, Bash, WebFetch, Write","main","ad108f7eb3f6764136d02fb875772ebb34f54078","upstreams\u002Fsource-c\u002Fskills\u002Fgeo-schema",2,"https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar\u002FMarketing-Agent-OS","https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar","iamwaqargulzar.com","2026-11-03 21:14:34",{"source":8,"skillName":5,"commands":43,"prompt":53,"zipAvailable":54},[44,47,50],{"tool":45,"command":46},"npx","npx skills add iamwaqargulzar\u002FMarketing-Agent-OS --skill geo-schema",{"tool":48,"command":49},"bunx","bunx skills add iamwaqargulzar\u002FMarketing-Agent-OS --skill geo-schema",{"tool":51,"command":52},"pnpm","pnpm dlx skills add iamwaqargulzar\u002FMarketing-Agent-OS --skill geo-schema","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar\u002FMarketing-Agent-OS\u002Fblob\u002Fmain\u002Fupstreams\u002Fsource-c\u002Fskills\u002Fgeo-schema\u002FSKILL.md",true,[],[57,64,71,78,85,92],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M7AG5VYEX7J2R2AAD54A7YT7","video","When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use when the user mentions 'video production,' 'AI video,' 'Remotion,' 'Hyperframes,' 'HeyGen,' 'Synthesia,' 'Veo,' 'Sora,' 'Runway,' 'Kling,' 'Seedance,' 'Hailuo,' 'MiniMax,' 'Pika,' 'Hunyuan,' 'Wan,' 'video generation,' 'AI avatar,' 'talking head video,' 'programmatic video,' 'video template,' 'explainer video,' 'product demo video,' 'record a product demo,' 'feature demo video,' 'in-app demo,' 'video pipeline,' 'copy this edit,' 'match this video style,' 'reverse-engineer this video,' 'edit like this reference,' or 'make me a video.' Use this for video creation, generation, and production workflows. For video content strategy and what to post, see social. For paid video ad creative, see ad-creative.","https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar\u002FMarketing-Agent-OS\u002Fblob\u002Fmain\u002Fupstreams\u002Fsource-d\u002Fskills\u002Fvideo\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7AG5FMXWA33FQDNS9PS1TE6","social","When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter\u002FX, Instagram, TikTok, or Facebook, or wants to do social listening and engagement triage. Also use when the user mentions 'LinkedIn post,' 'Twitter thread,' 'social media,' 'content calendar,' 'social scheduling,' 'engagement,' 'viral content,' 'what should I post,' 'repurpose this content,' 'tweet ideas,' 'LinkedIn carousel,' 'social media strategy,' 'grow my following,' 'TikTok video,' 'Reels,' 'Shorts,' 'video script,' 'video hook,' 'short-form video,' 'create a reel,' 'social listening,' 'brand mentions,' 'competitor monitoring,' 'top posts to comment on,' 'find people asking for,' 'carousel,' 'slide-by-slide,' or 'document post.' Use this for social content, repurposing, scheduling, video scripts, and listening. Posts avoid AI tells like 'it's not X, it's Y' reveals and broetry. For broader content strategy, see content-strategy. For paid ads, see ad-creative. For earned media, see public-relations.","https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar\u002FMarketing-Agent-OS\u002Fblob\u002Fmain\u002Fupstreams\u002Fsource-d\u002Fskills\u002Fsocial\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M7AG559W96W3DGE31KXYY78S","sms","When the user wants to plan, build, or optimize SMS, MMS, or WhatsApp marketing — including welcome flows, abandoned cart texts, post-purchase, win-back, promotional sends, or transactional\u002Fauth SMS. Also use when the user mentions \"SMS marketing,\" \"text message campaigns,\" \"SMS sequence,\" \"SMS automation,\" \"abandoned cart text,\" \"post-purchase SMS,\" \"Klaviyo SMS,\" \"Postscript,\" \"Attentive,\" \"Twilio,\" \"A2P 10DLC,\" \"TCPA,\" \"SMS compliance,\" \"short code,\" \"toll-free SMS,\" \"MMS campaign,\" \"should I do SMS,\" \"SMS vs email,\" \"WhatsApp marketing,\" \"WhatsApp Business API,\" \"WhatsApp templates,\" or \"click-to-WhatsApp.\" For email sequences, see emails. For SMS copy framing, see copywriting. For opt-in popups that capture phone numbers, see popups.","https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar\u002FMarketing-Agent-OS\u002Fblob\u002Fmain\u002Fupstreams\u002Fsource-d\u002Fskills\u002Fsms\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M7AG4WJ9EDSECNTQN0FEAYCQ","site-architecture","When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking. Also use when the user mentions \"sitemap,\" \"site map,\" \"visual sitemap,\" \"site structure,\" \"page hierarchy,\" \"information architecture,\" \"IA,\" \"navigation design,\" \"URL structure,\" \"breadcrumbs,\" \"internal linking strategy,\" \"website planning,\" \"what pages do I need,\" \"how should I organize my site,\" \"site navigation,\" \"which website builder should I use,\" \"migrate my website,\" or \"add a blog to my existing site.\" Use this whenever someone is planning what pages a website should have, how they connect, and where to build them. NOT for XML sitemaps (that's technical SEO — see seo-audit). For SEO audits, see seo-audit. For structured data, see schema.","https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar\u002FMarketing-Agent-OS\u002Fblob\u002Fmain\u002Fupstreams\u002Fsource-d\u002Fskills\u002Fsite-architecture\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7AG4MH58GRMSHC0TADAWQ69","signup","When the user wants to optimize signup, registration, account creation, or trial activation flows. Also use when the user mentions \"signup conversions,\" \"registration friction,\" \"signup form optimization,\" \"free trial signup,\" \"reduce signup dropoff,\" \"account creation flow,\" \"people aren't signing up,\" \"signup abandonment,\" \"trial conversion rate,\" \"nobody completes registration,\" \"too many steps to sign up,\" or \"simplify our signup.\" Use this whenever the user has a signup or registration flow that isn't performing. For post-signup onboarding, see onboarding. For lead capture forms (not account creation), see cro.","https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar\u002FMarketing-Agent-OS\u002Fblob\u002Fmain\u002Fupstreams\u002Fsource-d\u002Fskills\u002Fsignup\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M7AG4CGGH35KYDFHYSS1BQZ5","seo-audit","When 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 tags review,\" \"SEO health check,\" \"my traffic dropped,\" \"lost rankings,\" \"not showing up in Google,\" \"site isn't ranking,\" \"Google update hit me,\" \"page speed,\" \"core web vitals,\" \"crawl errors,\" \"indexing issues,\" \"stuck on page 2,\" \"striking distance keywords,\" \"title tag rewrite,\" \"low CTR,\" \"local SEO,\" \"Google Business Profile,\" or \"map pack.\" Use this even if the user just says something vague like \"my SEO is bad\" or \"help with SEO\" — start with an audit. For building pages at scale to target keywords, see programmatic-seo. For adding structured data, see schema. For AI search optimization, see ai-seo.","https:\u002F\u002Fgithub.com\u002Fiamwaqargulzar\u002FMarketing-Agent-OS\u002Fblob\u002Fmain\u002Fupstreams\u002Fsource-d\u002Fskills\u002Fseo-audit\u002FSKILL.md",[],[]]