/help-center-article-generator

name: help-center-article-generator
description: >
  Take support ticket clusters, FAQ patterns, product documentation, or feature specs
  and generate structured help center articles with step-by-step instructions, screenshot
  placeholders, troubleshooting sections, and related article links. Batch mode generates
  multiple articles from a ticket export. Pure reasoning skill.
tags: [content]

Help Center Article Generator

Turn support tickets into self-serve answers. Takes repeated questions, feature docs, or product specs and generates help center articles that reduce ticket volume.

**Built for:** Early-stage teams where the same 20 questions make up 80% of support tickets, and nobody has time to write help docs. The goal is to turn one afternoon of article generation into months of ticket deflection.

When to Use

• "Write help center articles for our top support questions"
• "Turn these support tickets into FAQ articles"
• "Generate docs for [feature]"
• "Build out our knowledge base"
• "Our support volume is too high — help me create self-serve content"

Phase 0: Intake

Content Source (provide any/all)

1. **Support ticket export** — CSV/list of recent tickets (subject, description, resolution). The skill will cluster them to find the top recurring topics. 2. **FAQ list** — Already know the top questions? Provide them directly. 3. **Feature documentation** — Internal docs, PRDs, or specs for features that need customer-facing articles. 4. **Product walkthrough** — Describe the workflow step-by-step and the skill generates the article. 5. **Existing articles to improve** — URLs or text of current help articles that need rewriting.

Configuration

6. **Product name** — What's the product called? 7. **Audience** — Who reads these? (Technical users, non-technical, mixed) 8. **Tone** — Casual/friendly, professional, technical/developer-docs? 9. **Article structure preference:**

• **Standard** — Overview → Steps → Troubleshooting → Related
• **Developer** — Overview → API reference → Code examples → Errors
• **Quick start** — What → Why → How (3 steps max) → Next

10. **Screenshot convention** — Do you use screenshots? (The skill will insert `[Screenshot: description]` placeholders) 11. **Batch or single?** — One article or generate multiple from a ticket export?

Phase 1: Topic Clustering (Batch Mode)

If provided a ticket export, cluster tickets into article topics:

Clustering Approach

1. **Group by similarity** — Cluster tickets with similar subject/description 2. **Rank by frequency** — Most common clusters = highest priority articles 3. **Identify article type** per cluster:

| Type | When to Use | Example | |------|-------------|---------| | **How-to** | "How do I do X?" | "How to set up email integration" | | **Troubleshooting** | "X isn't working" | "Fix: emails not sending" | | **Concept/Overview** | "What is X?" | "Understanding billing plans" | | **Reference** | "What are the options for X?" | "API rate limits and quotas" | | **Getting Started** | First-time setup | "Quick start: your first campaign" |

Cluster Output

TOPIC CLUSTERS (ranked by ticket frequency):

1. [Topic] — [N tickets] — Type: [How-to]
   Common phrasing: "[How customers ask this question]"
   Resolution pattern: [What support typically tells them]

2. [Topic] — [N tickets] — Type: [Troubleshooting]
   ...

3. ...

Phase 2: Article Generation

Article Template — How-to

# [Action-oriented title — e.g., "How to Set Up Email Integration"]

[1-2 sentence overview: What this article covers and who it's for]

**Time to complete:** [X minutes]
**Prerequisites:** [What they need before starting — e.g., "Admin access, API key"]

---

## Step 1: [Action verb + what to do]

[1-2 sentences explaining this step]

[Screenshot: Description of what the user should see — e.g., "Settings page with Integrations tab highlighted"]

> **Tip:** [Helpful context or shortcut]

## Step 2: [Action verb + what to do]

[Instructions]

[Screenshot: Description]

## Step 3: [Action verb + what to do]

[Instructions]

---

## Verify It Worked

[How to confirm the setup was successful]

[Screenshot: Description of success state]

---

## Troubleshooting

### [Common problem 1]
**Symptom:** [What the user sees]
**Cause:** [Why this happens]
**Fix:** [Step-by-step resolution]

### [Common problem 2]
**Symptom:** [...]
**Cause:** [...]
**Fix:** [...]

---

## FAQ

**Q: [Common follow-up question]**
A: [Answer]

**Q: [Another common question]**
A: [Answer]

---

## Related Articles

- [[Article title]] — [1-line description of when to read it]
- [[Article title]] — [...]

Article Template — Troubleshooting

# Fix: [Problem description — e.g., "Emails Not Sending"]

[1-2 sentences: When you'd encounter this problem]

---

## Quick Fix

Try this first (resolves ~80% of cases):

1. [Most common fix — step 1]
2. [Step 2]
3. [Verify]

---

## If That Didn't Work

### Check 1: [First thing to verify]
[How to check + what to look for]

✅ If [expected result] → This isn't the issue. Move to Check 2.
❌ If [unexpected result] → [Specific fix for this case]

### Check 2: [Second thing to verify]
[How to check]

✅ If OK → Move to Check 3.
❌ If not → [Fix]

### Check 3: [Third thing to verify]
[How to check]

✅ If OK → Move to "Still Not Working?"
❌ If not → [Fix]

---

## Still Not Working?

If none of the above resolved your issue:

1. [What information to gather — e.g., "Screenshot of the error message"]
2. [Where to get help — e.g., "Email support@company.com with the above info"]
3. [Expected response time]

---

## Why This Happens

[2-3 sentences explaining the root cause for curious users. Optional but builds trust.]

## Related Articles

- [[Article]] — [Context]

Article Template — Getting Started / Quick Start

# Getting Started with [Feature/Product]

[1-sentence: What you'll accomplish by the end of this guide]

**Time:** [X minute