FAQ Page Skill
Produce a single FAQ page with collapsible accordion sections, search, and category filtering.
Workflow
- Read the active DESIGN.md (injected above). Use the component tokens for
interactive elements (accordion headers, search input, category pills).
- Pick the domain from the brief (e.g., SaaS product, e-commerce, service)
and write 12–18 real FAQ entries across 3–4 categories.
- Edge cases:
- If the brief provides fewer than 8 FAQs, ask for more content or generate
realistic questions based on the domain.
- For 1–5 FAQs, skip categories and search; show a simple list.
- For very long answers (>100 words), break into paragraphs or bullet points
to maintain readability.
- Sections, in order:
- Header — page title ("Frequently Asked Questions" or "Help Center"),
optional subtitle (1 sentence explaining what users can find here).
- Search bar — prominent search input with placeholder text and icon.
Functional JS to filter questions in real-time.
- Category filters — 3–4 pill-style buttons to filter by category
(e.g., "Billing", "Account", "Technical", "General"). "All" selected by default.
- FAQ accordion — collapsible question/answer pairs:
- Question as clickable header with expand/collapse icon (chevron or plus/minus).
- Answer hidden by default, expands on click with smooth animation.
- Each entry has
data-category attribute for filtering.
- Footer CTA — "Still have questions?" section with contact link or
support email.
- Write a single HTML document:
<!doctype html> through </html>, CSS and JS inline.
- Accordion uses semantic HTML (
<details> and <summary> for progressive
enhancement, or custom JS with proper ARIA attributes).
- Search filters questions by matching text in question or answer.
- Category filters show/hide questions based on
data-category.
- Smooth transitions for expand/collapse (max-height or grid-template-rows).
data-od-id on header, search, categories, accordion container, footer.
- Self-check:
- Questions are specific and realistic (not generic placeholders).
- Answers are concise (2–4 sentences) but complete.
- Keyboard navigation works (Tab through questions, Enter to expand).
- Search is case-insensitive and filters by matching text.
- Only one accordion item expanded at a time (optional, depends on UX preference).
- Mobile-friendly (accordion headers are tappable, search is usable).
Output contract
Emit between <artifact> tags:
<artifact identifier="faq-page" type="text/html" title="FAQ Page">
<!doctype html>
<html>...</html>
</artifact>
One sentence before the artifact, nothing after.
Example questions by category
Billing
- How do I update my payment method?
- What payment methods do you accept?
- Can I get a refund?
- How do I cancel my subscription?
Account
- How do I reset my password?
- Can I change my email address?
- How do I delete my account?
- What happens to my data after I cancel?
Technical
- What browsers do you support?
- Is there a mobile app?
- How do I export my data?
- What are your API rate limits?
General
- What is [Product Name]?
- How do I get started?
- Do you offer customer support?
- Where can I find your terms of service?
1---2name: faq-page3description: A Frequently Asked Questions (FAQ) page with collapsible accordion sections, search functionality, and category filtering. Use when the brief asks for "FAQ", "help center", "questions", or "support page".4---56# FAQ Page Skill78Produce a single FAQ page with collapsible accordion sections, search, and category filtering.910## Workflow11121. **Read the active DESIGN.md** (injected above). Use the component tokens for13 interactive elements (accordion headers, search input, category pills).142. **Pick the domain** from the brief (e.g., SaaS product, e-commerce, service)15 and write 12–18 real FAQ entries across 3–4 categories.16 - **Edge cases**:17 - If the brief provides fewer than 8 FAQs, ask for more content or generate18 realistic questions based on the domain.19 - For 1–5 FAQs, skip categories and search; show a simple list.20 - For very long answers (>100 words), break into paragraphs or bullet points21 to maintain readability.223. **Sections**, in order:23 - **Header** — page title ("Frequently Asked Questions" or "Help Center"),24 optional subtitle (1 sentence explaining what users can find here).25 - **Search bar** — prominent search input with placeholder text and icon.26 Functional JS to filter questions in real-time.27 - **Category filters** — 3–4 pill-style buttons to filter by category28 (e.g., "Billing", "Account", "Technical", "General"). "All" selected by default.29 - **FAQ accordion** — collapsible question/answer pairs:30 - Question as clickable header with expand/collapse icon (chevron or plus/minus).31 - Answer hidden by default, expands on click with smooth animation.32 - Each entry has `data-category` attribute for filtering.33 - **Footer CTA** — "Still have questions?" section with contact link or34 support email.354. **Write** a single HTML document:36 - `<!doctype html>` through `</html>`, CSS and JS inline.37 - Accordion uses semantic HTML (`<details>` and `<summary>` for progressive38 enhancement, or custom JS with proper ARIA attributes).39 - Search filters questions by matching text in question or answer.40 - Category filters show/hide questions based on `data-category`.41 - Smooth transitions for expand/collapse (max-height or grid-template-rows).42 - `data-od-id` on header, search, categories, accordion container, footer.435. **Self-check**:44 - Questions are specific and realistic (not generic placeholders).45 - Answers are concise (2–4 sentences) but complete.46 - Keyboard navigation works (Tab through questions, Enter to expand).47 - Search is case-insensitive and filters by matching text.48 - Only one accordion item expanded at a time (optional, depends on UX preference).49 - Mobile-friendly (accordion headers are tappable, search is usable).5051## Output contract5253Emit between `<artifact>` tags:5455```56<artifact identifier="faq-page" type="text/html" title="FAQ Page">57<!doctype html>58<html>...</html>59</artifact>60```6162One sentence before the artifact, nothing after.6364## Example questions by category6566**Billing**67- How do I update my payment method?68- What payment methods do you accept?69- Can I get a refund?70- How do I cancel my subscription?7172**Account**73- How do I reset my password?74- Can I change my email address?75- How do I delete my account?76- What happens to my data after I cancel?7778**Technical**79- What browsers do you support?80- Is there a mobile app?81- How do I export my data?82- What are your API rate limits?8384**General**85- What is [Product Name]?86- How do I get started?87- Do you offer customer support?88- Where can I find your terms of service?