Skip to content
Get packs

FAQ Schema Markup

Adds and checks FAQPage JSON-LD structured data for FAQ sections on web pages

Source Download skill
Repository
thedaviddias/Front-End-Checklist
Stars
74,632
Licence
MIT
Files
2 files

What it does

This skill teaches the agent to add FAQPage structured data (a hidden JSON-LD block that describes questions and answers) to web pages that already show FAQ content, so search engines like Google can display expandable Q&A under the page in results. It also tells the agent how to check existing pages for correct, matching markup and to flag mismatches between the code and what users actually see.

Great for

  • Front-end developers adding FAQ sections to landing pages or blog posts
  • SEO-minded marketers who want to audit existing FAQ structured data
  • Teams preparing pages for Google rich results

Skip it if

  • Pages without visible FAQ content, since the skill itself warns that hidden or mismatched markup is ignored and can trigger a manual action from Google
  • Guaranteed search results: the skill describes possible benefits but cannot promise rich results or higher click-through

Try asking

  • “Add FAQPage JSON-LD to my pricing page based on the questions already shown on it”
  • “Check the structured data on our blog post FAQ section and tell me what's wrong”
  • “Generate FAQPage schema from this list of questions and answers I'm pasting”
  • “Validate that every question in our FAQ schema has a matching visible answer”
Step-by-step guide: how to use FAQ Schema MarkupInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 2 original files, the MIT licence and an attribution note.

    faq.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip faq.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip faq.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Give the agent the exact visible FAQ text so the schema matches the page word for word
  • After the agent writes the markup, check it with Google's Rich Results Test, since the skill only recommends that step and does not run it
  • Review references/rule.md for framework-specific examples before deploying to a production site

What's inside

  • references/rule.md
  • SKILL.md

Redistributed unmodified from thedaviddias/Front-End-Checklist under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.