gooseworks-ai/help-center-article-generator

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 [email protected] 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 minutes] | **Difficulty:** [Beginner/Intermediate]

---

## What You'll Need

- [Prerequisite 1]
- [Prerequisite 2]

---

## Step 1: [First thing to do] (2 min)

[Clear instructions]

[Screenshot: Description]

## Step 2: [Second thing] (3 min)

[Instructions]

## Step 3: [Third thing] (2 min)

[Instructions]

---

## You're All Set! 🎉

[What they can now do]

**Next steps:**
- [Logical next action — link to next article]
- [Power user tip — link to advanced article]
- [Join community — link if applicable]

Phase 3: Article Quality Check

For each generated article, verify:

• [ ] Title is action-oriented — Starts with "How to", "Fix:", "Getting Started", or "Understanding"
• [ ] Scannable — Headers, numbered steps, bold key terms. No walls of text.
• [ ] Complete — Covers the full workflow, not just the happy path
• [ ] Troubleshooting included — At least 2 common failure scenarios
• [ ] No jargon — Uses the customer's language, not internal terminology
• [ ] Screenshot placeholders — Every step that involves UI has a placeholder
• [ ] Related articles linked — Cross-references to keep users in the help center
• [ ] Search-friendly — Title and first paragraph contain keywords customers actually search for

Phase 4: Output

Single Article Mode

Save to the current working directory as [article-slug].md.

Batch Mode

Save all articles to a help-center/ subdirectory in the current working directory, with an _index.md table of contents.

Index Template

# Help Center — [Product Name]
Generated: [DATE] | Articles: [N]

## Getting Started
- [[getting-started-guide.md]] — First-time setup walkthrough
- [[quick-start.md]] — 5-minute quick start

## How-To Guides
- [[how-to-setup-email.md]] — Set up email integration
- [[how-to-invite-team.md]] — Invite team members
- ...

## Troubleshooting
- [[fix-emails-not-sending.md]] — Emails not sending
- [[fix-login-issues.md]] — Can't log in
- ...

## Reference
- [[api-rate-limits.md]] — API limits and quotas
- [[billing-plans.md]] — Plan comparison and billing FAQ

Cost

| Component | Cost | |-----------|------| | All article generation | Free (LLM reasoning) | | Total | Free |

Tools Required

None. Pure reasoning skill — takes raw input and produces structured articles.

Trigger Phrases

• "Write help center articles from our support tickets"
• "Generate docs for [feature]"
• "Build out our knowledge base"
• "Turn our FAQs into help articles"
• "Run help center article generator"