schema-json-optimization

Validate JSON-LD structured data and generate schema recommendations for rich results.

7|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/thisisAhsanIqbal/nextjs-seo-audit --skill schema-json-optimization
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: schema-json-optimization
Source: https://github.com/thisisAhsanIqbal/nextjs-seo-audit/tree/main/skills/schema-json-optimization
Command: npx skills add https://github.com/thisisAhsanIqbal/nextjs-seo-audit --skill schema-json-optimization

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you audit JSON-LD structured data by validating existing JSON-LD markup and recommending only the schema types that match the detected page context, improving your chances of eligibility for rich results.

Core Features & Use Cases

  • Validates existing JSON-LD: Finds <script type="application/ld+json"> blocks, checks for parse errors, and verifies required keys like @context and @type.
  • Auto-detects page type: Detects Article/Blog, LocalBusiness, Product, FAQ, Organization, BreadcrumbList, and WebSite signals from the HTML.
  • Suggests relevant schemas only: Flags missing schema fields and generates targeted schema templates only for page types that actually apply.

Quick Start

Use the schema-json-optimization skill to validate the JSON-LD on the current page and receive pass/warn/fail findings plus schema suggestions tailored to the page’s detected type.

Frequently Asked Questions about schema-json-optimization

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate JSON-LD structured data for rich results eligibility?

To validate JSON-LD structured data, you need to locate application/ld+json blocks, parse the JSON safely, and enforce required keys like @context and @type to ensure rich results eligibility. This process detects parse errors and verifies type-specific fields.

What is the best way to audit schema markup for an Article or Product page?

Auditing schema markup involves detecting page type signals from the HTML and then validating only the applicable schema fields for types like Article, Product, or LocalBusiness. This targeted approach flags missing fields and generates tailored schema templates.

How do I check if my FAQ schema markup is missing required fields?

Checking FAQ schema markup requires parsing the JSON-LD blocks and enforcing type-specific required fields. By detecting FAQ signals on your page, the validation process identifies missing schema fields and suggests the correct structure.

Does JSON-LD validation work for different HTML page types?

JSON-LD validation works for any HTML page by auto-detecting page type signals for Article, LocalBusiness, Product, FAQ, Organization, BreadcrumbList, and WebSite. It then applies validation checks only to the detected schema types.

Why does my BreadcrumbList schema fail the SEO audit?

Your BreadcrumbList schema fails the SEO audit because the JSON-LD block contains parse errors or is missing required keys such as @context and @type. Validating structured data safely locates these blocks and enforces type-specific field presence.

Do I need to manually specify schema types when checking structured data?

You do not need to manually specify schema types when checking structured data. The validation process auto-detects relevant page type signals from the HTML and recommends only the schema types that match the detected page context.