.cursor/skills/faq-schema-creator/SKILL.md
Create FAQ content and JSON-LD schema markup optimized for AI search. Use when building FAQ sections, help documentation, or Q&A content that should be easily extracted and cited by AI assistants.
npx skillsauth add ihmissuti/kimmoihanus-nextjs-site faq-schema-creatorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Create FAQ content and structured data that AI search engines can easily extract, understand, and cite in their answers.
FAQs are one of the most effective content formats for AI search visibility:
Good questions:
Examples:
# Good
What is Generative Engine Optimization (GEO)?
How does GEO differ from traditional SEO?
How often should I update content for AI search?
What are the key metrics for measuring GEO success?
# Bad (too vague or not searchable)
Tell me about optimization
What's the deal with AI?
Can you explain more?
More info please
Follow these guidelines for AI-friendly answers:
Answer template:
### [Question]?
[Direct answer in 1-2 sentences]. [Supporting detail or context].
[Example or specific recommendation if relevant].
Example:
### What is Generative Engine Optimization (GEO)?
GEO (Generative Engine Optimization) is the practice of optimizing
content to be discovered and cited by AI search engines like ChatGPT,
Perplexity, and Google AI Mode. Unlike traditional SEO which focuses
on search rankings, GEO focuses on brand visibility, citation rate,
and share of voice inside AI-generated answers.
Organize FAQs by topic for better structure:
## Product Questions
### What does [Product] do?
[Clear description of core functionality]
### How much does [Product] cost?
[Pricing information with tiers if applicable]
### What platforms/integrations are supported?
[List of compatible platforms]
### Is there a free trial?
[Trial details, duration, limitations]
## Getting Started
### How do I sign up for [Product]?
[Step-by-step signup process]
### How do I configure [Feature]?
[Configuration instructions]
### How long does setup take?
[Time estimate with context]
## Comparisons
### How does [Product] compare to [Competitor]?
[Objective comparison highlighting differences]
### What makes [Product] different?
[Unique value propositions]
### Is [Product] better for [use case A] or [use case B]?
[Use case recommendations]
## Troubleshooting
### Why isn't [Feature] working?
[Common causes and solutions]
### How do I fix [Error]?
[Step-by-step resolution]
### Who do I contact for support?
[Support channels and response times]
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is Generative Engine Optimization (GEO)?",
"acceptedAnswer": {
"@type": "Answer",
"text": "GEO (Generative Engine Optimization) is the practice of optimizing content to be discovered and cited by AI search engines like ChatGPT, Perplexity, and Google AI Mode. Unlike traditional SEO which focuses on search rankings, GEO focuses on brand visibility, citation rate, and share of voice inside AI-generated answers."
}
},
{
"@type": "Question",
"name": "How does GEO differ from traditional SEO?",
"acceptedAnswer": {
"@type": "Answer",
"text": "While SEO focuses on ranking pages in search results and driving clicks, GEO focuses on being mentioned and cited inside AI-generated answers. Key GEO metrics include brand visibility percentage, citation frequency, AI share of voice, and context accuracy."
}
},
{
"@type": "Question",
"name": "How often should content be updated for GEO?",
"acceptedAnswer": {
"@type": "Answer",
"text": "High-value pages should be refreshed every 60-90 days to maintain freshness signals. Update statistics, examples, and publication dates. AI engines prioritize recently updated content when generating answers."
}
}
]
}
{
"@context": "https://schema.org",
"@type": "FAQPage",
"name": "Generative Engine Optimization FAQ",
"description": "Frequently asked questions about GEO and AI search optimization",
"dateModified": "2026-01-15",
"mainEntity": [
{
"@type": "Question",
"name": "What are the key metrics for measuring GEO success?",
"acceptedAnswer": {
"@type": "Answer",
"text": "The key GEO metrics are: 1) Brand Visibility - percentage of AI answers mentioning your brand, 2) Citation Rate - how often AI cites your content as a source, 3) AI Share of Voice - your mentions compared to competitors, 4) Context Accuracy - whether AI describes your brand correctly. Most companies target 20-30% brand visibility on non-branded category queries as a first-year goal."
}
}
]
}
<!DOCTYPE html>
<html lang="en">
<head>
<title>FAQ - [Topic] | [Brand]</title>
<meta
name="description"
content="Frequently asked questions about
[topic]. Get answers to common questions about [specific areas]."
/>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "Question text here?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Answer text here."
}
}
]
}
</script>
</head>
<body>
<main>
<h1>Frequently Asked Questions</h1>
<section>
<h2>Getting Started</h2>
<article>
<h3>What is [Product]?</h3>
<p>[Answer]</p>
</article>
<article>
<h3>How do I get started?</h3>
<p>[Answer]</p>
</article>
</section>
<section>
<h2>Pricing & Plans</h2>
<article>
<h3>How much does [Product] cost?</h3>
<p>[Answer]</p>
</article>
</section>
</main>
</body>
</html>
# Frequently Asked Questions
## Getting Started
### What is [Product]?
[Product] is [clear one-sentence description]. It helps [target user]
to [primary benefit]. Key features include [feature 1], [feature 2],
and [feature 3].
### How do I get started with [Product]?
Getting started takes about [time estimate]. First, [step 1]. Then,
[step 2]. Finally, [step 3]. You can find detailed setup instructions
in our documentation.
## Pricing & Plans
### How much does [Product] cost?
[Product] offers [number] pricing tiers:
- **Starter:** $X/month - [key features]
- **Professional:** $X/month - [key features]
- **Enterprise:** Custom pricing - [key features]
All plans include [common features]. See our pricing page for details.
### Is there a free trial?
Yes, [Product] offers a [duration] free trial with access to [features].
No credit card required to start.
## Technical Questions
### What integrations are supported?
[Product] integrates with [platform 1], [platform 2], and [platform 3].
We also offer a REST API for custom integrations. See our integrations
page for the complete list.
<head> section| Priority | Criteria | Action | | -------- | ---------------------------------------- | ------------------ | | High | Asked frequently + high business impact | Create immediately | | Medium | Asked frequently OR high business impact | Create soon | | Low | Rarely asked, low business impact | Consider later |
Before deploying, validate your FAQ schema:
Common schema errors to avoid:
name or text propertiesdata-ai
Generate and optimize Schema.org structured data for AI/LLM visibility. Use when adding schema markup, improving structured data, or optimizing for rich results and AI search engines.
development
Audit websites for AI search visibility and Generative Engine Optimization (GEO). Use when auditing a website for LLM/AI search presence, checking how ChatGPT or Perplexity see a brand, or optimizing content for AI recommendations.
tools
Score developer tools and SaaS products for AI agent compatibility. Use when evaluating how well a devtool works with AI coding assistants, or when optimizing a product for the agent era.
documentation
Generate JSON-LD schema markup for GEO optimization. Use when creating structured data for articles, products, FAQs, how-to guides, organizations, and other content types to improve AI search visibility and rich results.