AGENT SKILL

seo-aeo-schema-generator

Generates valid JSON-LD structured data for 10 schema types with rich result eligibility validation and implementation-ready script blocks. Activate when the user wants to generate schema markup, JSON-LD, or structured data for any page.

License 许可
MIT
最近更新
2026-05-10
Stars
★ 1
Forks
1

01 前言 Front Matter

name
seo-aeo-schema-generator
risk
safe
source
community
date_added
2026-04-01
description
Generates valid JSON-LD structured data for 10 schema types with rich result eligibility validation and implementation-ready script blocks. Activate when the user wants to generate schema markup, JSON-LD, or structured data for any page.

03 SKILL.md 正文

SEO-AEO Schema Generator

Overview

Generates implementation-ready JSON-LD schema markup for 10 schema types including FAQPage, Article, Product, HowTo, and BreadcrumbList. Validates all required fields against Google rich result eligibility rules, flags missing fields with exact fix instructions, and outputs one clean <script> block per schema type ready to paste into the page <head>.

Part of the SEO-AEO Engine.

When to Use This Skill

  • Use when adding structured data to a new landing page or blog post
  • Use when a page needs FAQ rich results or product star ratings in search
  • Use when validating existing schema for Google rich result eligibility
  • Use after the content-quality-auditor flags missing schema

Supported Schema Types

Type Rich Result Unlocked
FAQPage FAQ accordion in SERP — AEO critical
Article Article rich result, Top Stories
Product Price, availability, rating in SERP
HowTo Step-by-step rich result
Review Star rating in SERP
AggregateRating Star rating with review count
BreadcrumbList Breadcrumb path in SERP URL
Organization Brand knowledge panel signals
WebPage Enhanced page understanding
WebSite Sitelinks Searchbox

How It Works

Step 1: Recommend Schema Types

If schema types are not specified, recommend the appropriate types based on the page type. Landing pages get FAQPage + Product + BreadcrumbList. Blog posts get Article + FAQPage + BreadcrumbList.

Step 2: Use Built-In Schema Templates

Using your knowledge of schema.org and Google's rich result requirements, construct the JSON-LD template for each requested schema type. Use the required and recommended fields listed in the Google Rich Results documentation for that type.

Step 3: Populate Fields

Map all page data to template placeholders. Check every required field against the rich result eligibility rules.

Step 4: Validate

Flag any missing required field as a Critical issue. Flag missing recommended fields as warnings. Do not output schema with missing required fields.

Step 5: Output Script Blocks

Write one <script type="application/ld+json"> block per schema type. Include implementation instructions and testing tool links.

Examples

Example: FAQPage Schema Output

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is Syncro?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Syncro is a remote-first project management platform for distributed engineering teams. It centralises task tracking, async communication, and sprint planning in one tool."
      }
    }
  ]
}
</script>

Best Practices

  • ✅ Do: Always include FAQPage schema on any page with a FAQ section — it is the strongest AEO signal
  • ✅ Do: Use one <script> block per schema type — never combine multiple types
  • ✅ Do: Test every output in Google's Rich Results Test before deploying
  • ❌ Don't: Use relative URLs anywhere in schema — all URLs must start with https://
  • ❌ Don't: Leave placeholder text in any field before deploying
  • ❌ Don't: Use HTML tags inside JSON-LD string values

Common Pitfalls

  • Problem: Schema passes validation but rich result doesn't appear in search Solution: Rich results can take weeks to appear after deployment. Request re-indexing in Google Search Console immediately after adding schema.

  • Problem: Product schema missing star rating display Solution: Add AggregateRating object with ratingValue, reviewCount, bestRating, and worstRating — all four fields required.

Related Skills

  • @seo-aeo-landing-page-writer — provides the FAQ and product data for schema population
  • @seo-aeo-content-quality-auditor — flags schema gaps during the audit

Additional Resources

Limitations

  • Use this skill only when the task clearly matches the scope described above.
  • Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
  • Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

04 同仓库更多 Skills

Sansar35
Sansar35/claude-agent

zustand-store-ts

Create Zustand stores following established patterns with proper TypeScript types and middleware.

★ 1
Sansar35
Sansar35/claude-agent

zod-validation-expert

Expert in Zod — TypeScript-first schema validation. Covers parsing, custom errors, refinements, type inference, and integration with React Hook Form, Next.js, and tRPC.

★ 1
Sansar35
Sansar35/claude-agent

zinc-database

Access ZINC (230M+ purchasable compounds). Search by ZINC ID/SMILES, similarity searches, 3D-ready structures for docking, analog discovery, for virtual screening and drug discovery.

★ 1
Sansar35
Sansar35/claude-agent

zarr-python

Chunked N-D arrays for cloud storage. Compressed arrays, parallel I/O, S3/GCS integration, NumPy/Dask/Xarray compatible, for large-scale scientific computing pipelines.

★ 1
Sansar35
Sansar35/claude-agent

zapier-workflows

Manage and trigger pre-built Zapier workflows and MCP tool orchestration. Use when user mentions workflows, Zaps, automations, daily digest, research, search, lead tracking, expenses, or asks to "run" any process. Also handles Perplexity-based research and Google Sheets data tracking.

★ 1
Sansar35
Sansar35/claude-agent

zapier-make-patterns

No-code automation democratizes workflow building. Zapier and Make (formerly Integromat) let non-developers automate business processes without writing code. But no-code doesn't mean no-complexity - these platforms have their own patterns, pitfalls, and breaking points. This skill covers when to use which platform, how to build reliable automations, and when to graduate to code-based solutions. Key insight: Zapier optimizes for simplicity and integrations (7000+ apps), Make optimizes for power

★ 1