--- name: self-service-knowledge-base description: 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, optimizing help center search, implementing self-service deflection, or analyzing knowledge base performance. Triggers on phrases like "knowledge base", "help center", "self-service", "help articles", "FAQ", "documentation", "search optimization", "article rating", "deflection rate", "knowledge base analytics", "content structure", "help content", "user guide", "troubleshooting guide", "how-to article", "KB article". --- # 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) ```