schema-markup

Installation
SKILL.md

Schema.org Structured Data

The general shape of JSON-LD and the common @type vocabulary is assumed knowledge. This skill captures only the things that are easy to get wrong: recent Google rich-result deprecations, exact magic strings, numeric constraints, and implementation gotchas.

Recent Google deprecations

Do not promise rich results for these types:

  • FAQPage rich results — For Google Search, these are now limited to well-known, authoritative government and health websites. For most other sites, FAQ markup will not usually produce visible FAQ rich results.
  • HowTo rich results — Deprecated in Google Search and no longer shown on desktop or mobile. Don't add HowTo markup just to chase Google rich results.
  • sameAs for Knowledge Panels — Still a valid structured-data property for disambiguation and linking to official profiles, but it is not a "claim or control your Knowledge Panel" lever.

When users ask for FAQ or HowTo schema, explain these limits first so they can decide whether the markup is still worth adding.

Choosing the right type

LLMs commonly pick the wrong @type:

  • Listicles / "best of" / "top 10" postsItemList with numbered ListItem entries (optionally wrapping Product, Review, or SoftwareApplication nodes). This is what triggers the numbered/carousel rich result. Defaulting to Article or BlogPosting on a listicle is a missed opportunity.
Related skills

More from rankearly/rankearly-skills

Installs
4
First Seen
Apr 10, 2026