faq-blocks-for-ai-answers/SKILL.md
Goal
Answer each real buyer question on the page in one place, with the answer first.
Workflow
- Collect real questions:
- Search Console queries for the page that have 8 or more words or start with how, what, why, can, does, is.
- Sales and support emails, chat logs, and "People also ask" boxes.
- Group the questions and drop the ones the page should not answer.
- For each question:
- Use the question as an H2 or H3, in the words people use.
- Answer in the first sentence. Then give the detail, a number, or a step list.
- Keep each answer to the facts on the site. Link to the page that has more detail.
- Put the block in the raw HTML, not in a script-only accordion. If the answers are in a collapsed accordion, keep the text in the HTML.
- Optionally add FAQPage markup (see faqpage-schema).
- Re-check the page queries in Search Console after a few weeks.
Rules
- One question per heading. No duplicate questions across pages.
- Do not invent statistics. Cite the source for any number.
- Keep the answer current. Add a "last updated" date if facts change.
Output
The FAQ block in HTML or Markdown, and a list of source queries per question.
Sources
- Google: Creating helpful, reliable, people-first content. https://developers.google.com/search/docs/fundamentals/creating-helpful-content