FrancoStino/seo-aeo-schema-generator
bundled-skills/seo-aeo-schema-generator/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add FrancoStino/opencode-skills-antigravity seo-aeo-schema-generatorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 26, 2026, 3:10 AM166.8s1 file scanned
SKILL.md
- name:
- seo-aeo-schema-generator
- 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.
- risk:
- safe
- source:
- community
- date_added:
- 2026-04-01
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
- SEO-AEO Engine Repository
- Full Schema Generator SKILL.md
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.
Related Skills
FrancoStino/youtube-full
development
VerifiedTrustedCommunity
Fetch YouTube transcripts, search videos, browse channels, and extract playlists via TranscriptAPI — no yt-dlp, no Google API key, works from any cloud server.
31SKILL.mdUpdated Jun 5, 2026
FrancoStino/yield-intelligence
development
VerifiedTrustedCommunity
Passive income portfolio analysis — activate when user asks about dividend yields, Treasury rates, REIT income, monthly passive income goals, or portfolio yield optimization. Scans 4 asset classes, ranks by risk-adjusted return, and builds allocations targeting a specific monthly income.
31SKILL.mdUpdated Jun 5, 2026
FrancoStino/vibecode-production-qa-validator
devops
VerifiedTrustedCommunity
End-to-end production QA, build verification, and launch-readiness checklist for fullstack Next.js apps. Covers TypeScript, linting, tests, build, SEO tags, route regression, and sitemap validation.
31SKILL.mdUpdated Jun 5, 2026
FrancoStino/vibe-code-cleanup
development
VerifiedTrustedCommunity
Safe production cleanup and hardening for vibe-coded fullstack apps (Next.js, React, Node.js, etc.). Removes dead imports, unused files, and broken references without breaking routes or APIs.
31SKILL.mdUpdated Jun 5, 2026