Skip to content
generating-faqs-and-help-content logo

FAQ & Help Center Generator

generating-faqs-and-help-content

Builds comprehensive FAQs and help center articles from customer questions and product documentation. Use when the user asks about FAQ pages, help centers, knowledge bases, support documentation, or customer questions.

SKILL.md

Full skill instructions

FAQ & Help Center Generator

When to use this skill

  • User asks to create FAQ content
  • User needs help center articles
  • User wants to organize customer questions
  • User mentions knowledge base content
  • User needs support documentation

Workflow

  • Gather question sources
  • Identify common questions
  • Organize by category
  • Write clear answers
  • Structure for search
  • Create help center hierarchy

Instructions

Step 1: Identify Question Sources

Common sources for FAQs:

SourceHow to AccessQuestion Quality
Support ticketsHelp desk exportsHigh - real problems
Chat logsLive chat transcriptsHigh - specific issues
Sales callsCRM notes, call recordingsMedium - pre-purchase
ReviewsApp stores, G2, TrustpilotMedium - public feedback
Social commentsSocial listeningMedium - casual questions
Search queriesSite search, Google SCHigh - user intent
User surveysSurvey responsesHigh - direct feedback
Community forumsForum threadsHigh - detailed questions

Question extraction template:

## Question Extraction: [Source]

**Date reviewed:** [Date]
**Questions identified:** [Count]

| Question   | Frequency | Category   | Priority     |
| ---------- | --------- | ---------- | ------------ |
| [Question] | [Count]   | [Category] | High/​Med/​Low |

Step 2: Question Categorization

Standard FAQ categories:

CategoryTopics Covered
Getting StartedSetup, onboarding, first steps
Account & BillingPricing, payments, cancellation
Features & UsageHow to use, capabilities
TroubleshootingErrors, issues, fixes
IntegrationsThird-party connections
Security & PrivacyData, compliance, safety
Shipping & DeliveryFor e-commerce
Returns & RefundsPolicies, processes

Category hierarchy template:

## Help Center Structure

### 1. Getting Started

- What is [Product]?
- How do I create an account?
- First steps after signup
- Quick start guide

### 2. Account & Billing

- How do I upgrade my plan?
- How do I cancel my subscription?
- What payment methods do you accept?
- How do I update billing information?

### 3. [Feature Category]

- How do I [common action]?
- Can I [capability question]?
- What are the limits of [feature]?

### 4. Troubleshooting

- Why isn't [feature] working?
- How do I fix [common error]?
- I can't log in - what should I do?

### 5. Integrations

- How do I connect [integration]?
- Which tools do you integrate with?
- Troubleshooting [integration] issues

Step 3: Answer Structure

FAQ answer format:

## [Question as headline - exact words people use]

[Direct answer in first sentence - no preamble]

[Additional context or explanation if needed - 2-3 sentences max]

**Steps (if applicable):**

1. [Step 1]
2. [Step 2]
3. [Step 3]

**Note:** [Important caveat or tip]

**Related articles:**

- [Link to related FAQ]
- [Link to related FAQ]

Answer examples:

## How do I cancel my subscription?

You can cancel your subscription anytime from your account settings.

Go to **Settings → Billing → Cancel Subscription** and follow the prompts.
Your access continues until the end of your current billing period.

**Steps:**

1. Log in to your account
2. Click your profile icon → Settings
3. Select Billing from the sidebar
4. Click Cancel Subscription
5. Confirm cancellation

**Note:** Canceling doesn't delete your data. You can reactivate anytime.

**Related articles:**

- How do I get a refund?
- What happens to my data after I cancel?

Step 4: Writing Guidelines

FAQ writing best practices:

DoDon't
Start with the answerStart with "Great question!"
Use the exact words customers useUse internal jargon
Keep answers under 200 wordsWrite essays
Include steps for processesAssume knowledge
Link to related contentLeave dead ends
Update regularlyLet content go stale

Tone guidelines:

SituationToneExample
Simple how-toDirect, clear"Click Settings, then..."
Error/​problemEmpathetic, helpful"We understand this is frustrating. Here's how to fix it..."
Policy questionProfessional, transparent"Our refund policy allows..."
Feature requestAppreciative, honest"Thanks for the suggestion! Currently, we don't support..."

Step 5: SEO Optimization

FAQ SEO elements:

ElementBest Practice
Title/​H1Use exact question (how people search)
URLShort, keyword-rich slug
Meta descriptionAnswer preview (156 chars)
HeadersH2 for main question, H3 for sub-sections
Internal linksLink related FAQs
Schema markupUse FAQPage or HowTo schema

FAQ schema example:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "How do I cancel my subscription?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "You can cancel your subscription anytime from your account settings. Go to Settings → Billing → Cancel Subscription."
      }
    }
  ]
}

Step 6: Help Article Template

For longer help center articles:

# [Action-oriented title]

[One-sentence summary of what this article covers]

## Before you begin

[Prerequisites, requirements, or context needed]

- Requirement 1
- Requirement 2

## [Main process heading]

### Step 1: [Action verb]

[Explanation]

[Screenshot or visual if helpful]

### Step 2: [Action verb]

[Explanation]

### Step 3: [Action verb]

[Explanation]

## Troubleshooting

### [Common issue 1]

[Solution]

### [Common issue 2]

[Solution]

## Related articles

- [Article 1]
- [Article 2]
- [Article 3]

## Still need help?

[Contact support CTA]

Step 7: FAQ Prioritization

Priority matrix:

Question TypeFrequencyImpactPriority
Blocking issuesHighHigh🔥 Critical
Common confusionHighMedium⚡ High
Nice-to-knowMediumLow📋 Normal
Edge casesLowLow📝 Low

Prioritization template:

## FAQ Priority List

### Critical (Create first)

- [ ] [Question] - Blocks user from completing core action
- [ ] [Question] - Causes support ticket surge

### High Priority

- [ ] [Question] - Asked weekly in support
- [ ] [Question] - Common pre-purchase question

### Normal Priority

- [ ] [Question] - Asked occasionally
- [ ] [Question] - Feature clarification

### Low Priority

- [ ] [Question] - Rare edge case
- [ ] [Question] - Advanced user query

Step 8: Help Center Navigation

Navigation structure:

## Help Center Architecture

### Main Navigation

├── Getting Started
│ ├── Quick Start Guide
│ ├── Account Setup
│ └── First Steps
├── Features
│ ├── [Feature 1]
│ │ ├── Overview
│ │ ├── How to Use
│ │ └── Troubleshooting
│ └── [Feature 2]
├── Account & Billing
│ ├── Manage Subscription
│ ├── Payment Methods
│ └── Invoices
├── Integrations
│ ├── [Integration 1]
│ └── [Integration 2]
└── Troubleshooting
├── Common Issues
└── Error Messages

### Search Optimization

- Add search synonyms for common terms
- Include common misspellings
- Tag articles with related keywords

Step 9: Maintenance Schedule

Keep FAQs current:

TaskFrequencyResponsible
Review support tickets for new questionsWeeklySupport lead
Update outdated answersMonthlyContent team
Check for dead linksMonthlyContent team
Audit most-viewed articlesQuarterlyProduct team
Full help center reviewBi-annuallyAll teams

Update checklist:

## FAQ Maintenance: [Month]

- [ ] Review top 10 support tickets from last month
- [ ] Identify new FAQs needed
- [ ] Update articles affected by product changes
- [ ] Check analytics for low-performing articles
- [ ] Verify all links work
- [ ] Update screenshots if UI changed

Output Format

## FAQ Content: [Product/​Feature]

**Categories:** [List of categories]
**Total FAQs:** [Count]

---

### Category: [Category Name]

#### [Question 1]

[Answer following the format guidelines]

**Related:** [Links]

---

#### [Question 2]

[Answer]

---

### Category: [Category Name]

[Continue with more Q&As]

---

## Help Center Structure

[Navigation hierarchy]

---

## Schema Markup

[FAQPage JSON-LD for all questions]

---

## Maintenance Notes

- Last updated: [Date]
- Next review: [Date]
- Questions to add: [List]

Validation

Before completing:

  • Questions use customer language
  • Answers start with direct response
  • Categories are logical and navigable
  • Internal links connect related FAQs
  • Answers are under 200 words
  • Steps are numbered for processes
  • SEO elements included
  • Schema markup provided

Error Handling

  • No question sources: Ask for access to support tickets, chat logs, or common customer questions.
  • Too many questions: Prioritize by frequency and impact; create top 20 first.
  • Questions too technical: Simplify language; have support team review.
  • No clear categories: Group by user journey stage (pre-purchase, setup, usage, troubleshooting).
  • Answers too long: Break into separate articles or use expandable sections.

Resources

More skills from majiayu000

xiaohongshu logo
majiayu000/claude-arsenal

xiaohongshu

xiaohongshu

286 148
View
agent-task-conductor logo
majiayu000/claude-skill-registry

agent-task-conductor

Conduct multi-agent task orchestration and workflow coordination.

663 1
View
conductor-setup logo
majiayu000/claude-skill-registry

conductor-setup

Initialize project with Conductor artifacts (product definition,

663 1
View
animation-designer logo
majiayu000/claude-skill-registry

animation-designer

Expert in web animations, transitions, and motion design using Framer Motion and CSS

663 1
View
diagramming logo
majiayu000/claude-skill-registry

diagramming

Creates Mermaid and ASCII diagrams for flowcharts, architecture, ERDs, state machines, mindmaps, and more. Use when user mentions diagram, flowchart, mermaid, ASCII diagram, text diagram, terminal diagram, visualize, C4, mindmap, architecture diagram, sequence diagram, ERD, or needs visual docume...

663 1
View
h3-pg logo
majiayu000/claude-skill-registry-data

h3-pg

PostgreSQL bindings for H3 hexagonal grid system. Use when working with H3 cells in Postgres, including spatial indexing, geometry/geography integration, and raster analysis.

23 1
View
conductor-development logo
majiayu000/claude-skill-registry

conductor-development

Context-Driven Development skill for projects using Conductor. Use this skill when you detect a `conductor/` directory in the project, when working on tasks defined in a `plan.md` file, or when the user asks about tracks, specs, or plans. Automatically applies TDD workflow, tracks task completion...

663 1
View
conductor-status logo
majiayu000/claude-skill-registry

conductor-status

Display project status, active tracks, and next actions

663 1
View
dockerization logo
majiayu000/claude-skill-registry

dockerization

Official Stakpak application containerization standard operating procedure, a step-by-step guidline to properly dockerize applications. This is a rule book curated by the Stakpak Team.

663 1
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View