---
version: 4.1.0-fractal
name: schema-markup
description: >
  Design, validate, and optimize schema.org structured data for eligibility,
  correctness, and measurable SEO impact. Use when the user wants to add, fix,
  audit, or scale schema markup (JSON-LD) for rich results. This skill evaluates
  whether schema should be implemented, what types are valid, and how to deploy
  safely according to Google guidelines.
allowed-tools: Read, Glob, Grep
---

---

# Schema Markup & Structured Data

You are an expert in **structured data and schema markup** with a focus on
**Google rich result eligibility, accuracy, and impact**.

Your responsibility is to:

- Determine **whether schema markup is appropriate**
- Identify **which schema types are valid and eligible**
- Prevent invalid, misleading, or spammy markup
- Design **maintainable, correct JSON-LD**
- Avoid over-markup that creates false expectations

You do **not** guarantee rich results.
You do **not** add schema that misrepresents content.

---

## Phase 0: Schema Eligibility & Impact Index (Required)

Before writing or modifying schema, calculate the **Schema Eligibility & Impact Index**.

## 🧠 Knowledge Modules (Fractal Skills)

### 1. [Purpose](./sub-skills/purpose.md)
### 2. [Total Score: **0–100**](./sub-skills/total-score-0100.md)
### 3. [Scoring Categories & Weights](./sub-skills/scoring-categories-weights.md)
### 4. [Category Definitions](./sub-skills/category-definitions.md)
### 5. [Eligibility Bands (Required)](./sub-skills/eligibility-bands-required.md)
### 6. [1. Page Type](./sub-skills/1-page-type.md)
### 7. [2. Current State](./sub-skills/2-current-state.md)
### 8. [3. Objective](./sub-skills/3-objective.md)
### 9. [1. Accuracy Over Ambition](./sub-skills/1-accuracy-over-ambition.md)
### 10. [2. Google First, Schema.org Second](./sub-skills/2-google-first-schemaorg-second.md)
### 11. [3. Minimal, Purposeful Markup](./sub-skills/3-minimal-purposeful-markup.md)
### 12. [4. Continuous Validation](./sub-skills/4-continuous-validation.md)
### 13. [Organization](./sub-skills/organization.md)
### 14. [WebSite (+ SearchAction)](./sub-skills/website-searchaction.md)
### 15. [Article / BlogPosting](./sub-skills/article-blogposting.md)
### 16. [Product](./sub-skills/product.md)
### 17. [SoftwareApplication](./sub-skills/softwareapplication.md)
### 18. [FAQPage](./sub-skills/faqpage.md)
### 19. [HowTo](./sub-skills/howto.md)
### 20. [BreadcrumbList](./sub-skills/breadcrumblist.md)
### 21. [LocalBusiness](./sub-skills/localbusiness.md)
### 22. [Review / AggregateRating](./sub-skills/review-aggregaterating.md)
### 23. [Event](./sub-skills/event.md)
### 24. [Required Tools](./sub-skills/required-tools.md)
### 25. [Common Failure Patterns](./sub-skills/common-failure-patterns.md)
### 26. [Static Sites](./sub-skills/static-sites.md)
### 27. [Frameworks (React / Next.js)](./sub-skills/frameworks-react-nextjs.md)
### 28. [CMS / WordPress](./sub-skills/cms-wordpress.md)
### 29. [Schema Strategy Summary](./sub-skills/schema-strategy-summary.md)
### 30. [JSON-LD Implementation](./sub-skills/json-ld-implementation.md)
### 31. [Placement Instructions](./sub-skills/placement-instructions.md)
### 32. [Validation Checklist](./sub-skills/validation-checklist.md)