Schema Markup Generator
Generate valid JSON-LD schema aligned to page type so Google rich results and AI summaries can cite your pages accurately.
Install
npx skills add https://github.com/aaron-he-zhu/seo-geo-claude-skills --skill schema-markup-generatorWhat is this skill?
- Maps blog guides, landing pages, FAQ, best-of lists, and testimonials to required and conditional schema types.
- Rich-result eligibility table across FAQ, How-To, Product, Review, Article, Breadcrumb, and Video.
- Generates JSON-LD with required vs optional property notes tied to visible on-page content.
- Combines multiple schema types in one JSON array when the page qualifies.
- Includes validation checklist and implementation guidance for deployment.
Adoption & trust: 4k installs on skills.sh; 2.1k GitHub stars; 2/3 security scanners passed (skills.sh audits).
Recommended Skills
Seo Auditcoreyhaines31/marketingskills
Copywritingcoreyhaines31/marketingskills
Twitter Automationqu-skills/skills
Marketing Psychologycoreyhaines31/marketingskills
Content Strategycoreyhaines31/marketingskills
Programmatic Seocoreyhaines31/marketingskills
Journey fit
Common Questions / FAQ
Is Schema Markup Generator safe to install?
skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.
SKILL.md
READMESKILL.md - Schema Markup Generator
# Schema Markup Generator — Detailed Instructions Compact workflow, schema mapping, implementation guidance, validation checklist, and FAQ example for the Schema Markup Generator skill. ## Step 1: Identify Content Type and Rich Result Opportunity Use CORE-EEAT `O05` to match content type to schema: | Content Type | Required Schema | Conditional Schema | |--------------|-----------------|--------------------| | Blog guide | Article, Breadcrumb | FAQ, HowTo | | Blog tools | Article, Breadcrumb | FAQ, Review | | Best-of / alternatives | ItemList, Breadcrumb, FAQ | AggregateRating | | Landing page | SoftwareApplication, Breadcrumb, FAQ | WebPage | | FAQ page | FAQPage, Breadcrumb | — | | Testimonial page | Review, Breadcrumb | FAQ, Person | Then evaluate rich-result eligibility: | Rich Result Type | Eligibility | Impact | |------------------|-------------|--------| | FAQ | Yes/No | High | | How-To | Yes/No | Medium | | Product | Yes/No | High | | Review | Yes/No | High | | Article | Yes/No | Medium | | Breadcrumb | Yes/No | Medium | | Video | Yes/No | High | ## Step 2: Generate Schema Markup For the chosen schema type: - Include all required properties - Add optional properties only when they are true and visible on page - Include a short rich-result preview - Split fields into required vs. optional notes - Note which fields affect rich-result eligibility - Combine multiple schema types inside one JSON array when needed > **Reference**: See [references/schema-templates.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/build/schema-markup-generator/references/schema-templates.md) for copy-start JSON-LD templates. ## Step 3: Provide Implementation and Validation ```markdown ## Implementation Guide ### Placement - `<head>` is preferred - Before `</body>` also works if the stack requires it ### Validation Checklist - [ ] JSON is valid - [ ] Required properties are present - [ ] URLs are absolute - [ ] Dates use ISO 8601 - [ ] Schema matches visible page content - [ ] No policy violations ``` Validation flow: 1. Test with ~~schema validator 2. Re-check in Schema.org Validator 3. Monitor ~~search console enhancements and rich-result reports ## Example FAQ Schema for SEO Page **User**: "Generate FAQ schema for a page about SEO with 3 questions" ```json { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "What is SEO?", "acceptedAnswer": { "@type": "Answer", "text": "[direct answer]" } }, { "@type": "Question", "name": "How long does SEO take?", "acceptedAnswer": { "@type": "Answer", "text": "[direct answer]" } }, { "@type": "Question", "name": "Is SEO better than paid ads?", "acceptedAnswer": { "@type": "Answer", "text": "[direct answer]" } } ] } ``` Wrap the JSON-LD in `<script type="application/ld+json">...</script>` and validate it before deployment. ## Schema Type Quick Reference | Content Type | Schema Type | Key Properties | |--------------|-------------|----------------| | Blog Post | BlogPosting / Article | headline, datePublished, author | | Product | Product | name, offers, availability | | FAQ | FAQPage | Question, Answer | | How-To | HowTo | step, totalTime | | Local Business | LocalBusiness | address, geo, openingHours | | Recipe | Recipe | ingredients, cookTime | | Event | Event | startDate, location | | Video | VideoObject | uploadDate, duration | | Course | Course | provider, name | | Review | Review | itemReviewed, ratingValue | ## Tips for Success Match visible content, avoid unsupported claims, keep values fresh, validate thoroughly, and watch Search Console after launch. # Schema Type Decision Tree Guidelines for selecting the right schema types based on content, industry, and implementation priority. --- ## When to Use Which Schema | Your Content | Primary Schema | Add If