Support AI Skill

Self Service Knowledge Base

Build and maintain self-service knowledge base and help center including article creation, search optimization, content structure, user feedback loops, and knowledge base analytics. Use when creating help articles, organizing knowledge base content, optimiz...

Self-Service Knowledge Base

Build and maintain self-service knowledge base and help center including article creation, search optimization, content structure, and analytics.

Workflow

1. Knowledge Base Architecture

KNOWLEDGE BASE STRUCTURE
═══════════════════════════════════════

Help Center Categories:
═══════════════════════════════════════

1. Getting Started
   → Account setup
   → First steps guide
   → Feature overview
   → Video tutorials

2. Product Guides
   → Feature A: How-to guides (5 articles)
   → Feature B: Step-by-step (8 articles)
   → Feature C: Configuration (4 articles)
   → Feature D: Best practices (3 articles)

3. Billing & Plans
   → Subscription management
   → Payment methods
   → Invoices & receipts
   → Plan comparison
   → Upgrade/downgrade guide

4. Troubleshooting
   → Common errors (12 articles)
   → Browser compatibility
   → Performance issues
   → Integration problems

5. Integrations
   → Integration A: Setup guide
   → Integration B: Configuration
   → Integration C: Troubleshooting
   → API documentation

6. Account & Security
   → Password reset
   → Two-factor authentication
   → Data export
   → Account deletion

7. Developer
   → API reference
   → Webhooks guide
   → SDK documentation
   → Rate limits

ARTICLE TYPES:
═══════════════════════════════════════

Type               Purpose                  Format               Examples
───────────────────────────────────────────────────────────────────────────────
How-to             Step-by-step guide       Numbered steps, screenshots "How to create a report"
Troubleshooting    Fix a specific issue     Problem → Cause → Solution "Fix error 500"
Concept            Explain a feature        Overview, use cases   "What is a workspace?"
FAQ                Answer common question   Q&A format            "How do I reset password?"
Release notes      New features/fixes       Changelog format      "Version 3.2.0 release notes"
Comparison         Compare options          Table, pros/cons      "Plan comparison"

2. Article Creation Workflow

ARTICLE CREATION PROCESS
═══════════════════════════════════════

1. Identify Need:
   → Support ticket trend (repeated questions)
   → Search with no results (search analytics)
   → Customer request (feedback, survey)
   → Product change (new feature, update)
   → Gap analysis (missing topic)

2. Research:
   → Gather information (product team, docs, screenshots)
   → Review existing articles (avoid duplication)
   → Identify target audience (new user, admin, developer)
   → Define scope (single topic, comprehensive)

3. Write (Template):
═══════════════════════════════════════

  # How to [Action] [Object]

  **Summary**: Brief description of what this article covers (1-2 sentences).

  **Prerequisites**:
  - Requirement 1
  - Requirement 2

  **Steps**:
  1. Navigate to [Location]
  2. Click [Button/Link]
  3. Enter [Information]
  4. Click [Button]

  **Result**: [Expected outcome]

  **Troubleshooting**:
  - If [issue], try [solution]
  - If [issue], try [solution]

  **Related Articles**:
  - [Link to related article 1]
  - [Link to related article 2]

  **Last Updated**: [Date]

  **Article ID**: [Unique identifier]

4. Review:
   → Technical accuracy (product team)
   → Clarity (non-technical reader test)
   → Completeness (all scenarios covered)
   → Screenshots (current, annotated)
   → Links (internal, external, functional)

5. Publish:
   → Assign to category
   → Add tags (search keywords)
   → Set visibility (public, authenticated, admin)
   → Update sitemap
   → Notify support team

3. Search Optimization

KNOWLEDGE BASE SEARCH OPTIMIZATION
═══════════════════════════════════════

Search Performance:
═══════════════════════════════════════

  Total searches: 45,000/month
  Zero-result searches: 3,200 (7.1%) — TARGET: <5%
  Click-through rate: 68% (target: ≥60%) ✓
  Average time to answer: 1.2 searches (target: <2) ✓

SEARCH BEST PRACTICES:
═══════════════════════════════════════

  → Synonyms: Map common terms (invoice = bill, sign in = login)
  → Autocomplete: Suggest popular searches (top 20)
  → Misspelling tolerance: Handle typos (fuzzy matching)
  → Weighted fields: Title > Headings > Body > Tags
  → Filters: Category, article type, date
  → Recent/popular: Show trending articles
  → Personalization: Show relevant based on role/plan

ZERO-RESULT SEARCH HANDLING:
═══════════════════════════════════════

  → Show related articles (similar content)
  → Show popular articles (fallback)
  → "Can't find what you're looking for?" → Contact support
  → "Suggest an article" → User feedback form
  → Log search terms → Content gap analysis (weekly)

TOP SEARCH TERMS (Last 30 Days):
═══════════════════════════════════════

Term                    Searches    Has Article    Status
───────────────────────────────────────────────────────────────
"reset password"        2,340       ✓ Yes          Top result
"billing"              1,890       ✓ Yes          Good results
"export data"          1,560       ✓ Yes          Top result
"cancel subscription"  1,230       ✓ Yes          Good results
"API rate limit"       980         ✓ Yes          Top result
"two factor auth"      870         ✓ Yes          Good results
"integration slack"    760         ✗ No           ← CREATE ARTICLE
"data backup"          650         ✗ No           ← CREATE ARTICLE
"SSO setup"            540         ✓ Yes          Update needed

4. Self-Service Deflection

SELF-SERVICE DEFLECTION METRICS
═══════════════════════════════════════

Deflection Rate:
═══════════════════════════════════════

  Metric              Before KB      After KB       Improvement
  ─────────────────────────────────────────────────────────────────────────────
  Support tickets     2,500/month    1,650/month    ↓ 34%
  KB-assisted tickets 0              450/month       New metric
  KB-only resolved    —              850/month       New metric
  Avg handle time     8 min          5 min (non-KB) ↓ 38%
  CSAT                82%            89%             ↑ 7pts
  First response time N/A            0 min (KB-only)  Instant

DEFLECTION STRATEGY:
═══════════════════════════════════════

  → Pre-chat widget: Show relevant articles before chat
  → Email templates: Link to KB articles in responses
  → Ticket comments: Auto-suggest articles (AI-powered)
  → Post-resolution: "Was this helpful?" → KB link
  → Proactive: In-app prompts for common issues
  → Deflection target: 40% (current: 34%, improving)

ARTICLE EFFECTIVENESS:
═══════════════════════════════════════

  Metric              Target        Current      Status
  ────────────────────────────────────────────────────────────────
  Article rating ≥4/5  ≥ 70%        76%          ✓ Good
  "This helped" rate   ≥ 75%        82%          ✓ Good
  Average time on page ≥ 60s        95s          ✓ Good
  Scroll depth ≥50%    ≥ 60%        68%          ✓ Good
  Follow-up tickets    ≤ 10%        8%           ✓ Good

5. Knowledge Base Analytics

KB PERFORMANCE DASHBOARD
═══════════════════════════════════════

Content Metrics:
═══════════════════════════════════════

  Total articles: 285
  Articles published (last 30 days): 12
  Articles updated (last 30 days): 28
  Articles rated: 198 (69% of traffic)
  Average rating: 4.3/5.0

Top 10 Articles (by views):
═══════════════════════════════════════

Rank  Article                              Views    Rating    Helped%
───────────────────────────────────────────────────────────────────────────────
1     How to reset your password           12,340   4.5       92%
2     Setting up two-factor authentication  8,760    4.6       89%
3     Billing and payment methods           7,650    4.2       85%
4     How to export your data              6,540    4.4       90%
5     Getting started guide                5,430    4.3       88%
6     API rate limits and quotas            4,320    4.1       82%
7     Integrating with Slack               3,890    4.5       91%
8     Troubleshooting login issues         3,450    4.0       78%
9     Plan comparison and pricing          2,980    3.9       75%
10    Data backup and restore              2,560    4.4       87%

CONTENT GAPS:
═══════════════════════════════════════

  → 15 high-volume searches with no article
  → 8 articles rated below 3.5/5 (need update)
  → 12 articles older than 6 months (review)
  → 5 topics with high follow-up tickets (improve clarity)

Edge Cases

Multi-language: Translation workflow, localization
Multi-product: Product-specific sections, cross-references
B2B vs B2C: Different complexity levels
Technical vs non-technical: Audience-appropriate language
Frequent updates: Version control, change notification

Integration Points

KB platform: Zendesk Guide, Help Scout, Intercom, Document360
CRM: Salesforce, HubSpot
Analytics: GA4, Mixpanel, Intercom analytics
AI: Search AI, article suggestion, auto-classification
CMS: WordPress, Contentful, Confluence
Support tool: Zendesk, Freshdesk, Front

Output

Knowledge Base Status

KNOWLEDGE BASE — Q4 2024
═══════════════════════════════════════

Articles: 285 (12 new, 28 updated this month)
Monthly searches: 45,000
Deflection rate: 34% (target: 40%)
Average rating: 4.3/5.0
Zero-result searches: 7.1% (target: <5%)
CSAT impact: +7pts (KB users vs non-KB)
Content gaps: 15 articles to create (priority: integration Slack, data backup)
Next review: Q1 2025 (full audit, update 8 low-rated articles)