--- name: knowledge-base-mgmt description: Build and maintain internal and external knowledge bases including article creation, content governance, search optimization, usage analytics, and contribution workflows. Use when creating help articles, organizing knowledge bases, managing content review cycles, optimizing KB search, or measuring KB effectiveness. Triggers on phrases like "knowledge base", "KB article", "help center", "documentation", "self-service", "article management", "content governance", "KB analytics". --- # Knowledge Base & Self-Service Build comprehensive knowledge bases that enable self-service support and reduce ticket volume. ## Workflow ### 1. Knowledge Base Strategy & Architecture 1. **KB content strategy**: - Define KB scope: product documentation, troubleshooting, FAQ, how-to guides, policy information - Audience segmentation: internal (support team, employees) vs external (customers, partners) - Content type classification: procedure, reference, troubleshooting, policy, FAQ - Information architecture: category hierarchy, tagging taxonomy, cross-referencing - Content ownership model (SMEs, technical writers, support agents) 2. **Platform selection and setup**: - KB platform evaluation (Confluence, Guru, Document360, Helpjuice, Zendesk Guide) - Template design: article templates for consistency - Navigation structure: categories, sections, sub-sections - Search engine configuration and optimization - Multi-language and accessibility compliance 3. **Governance and quality standards**: - Content creation guidelines (structure, tone, formatting, screenshots) - Review and approval workflow (author → reviewer → publisher) - Content freshness policy (quarterly review cycle) - Version control and change tracking - Quality rating system and feedback integration ### 2. Content Creation & Management 1. **Article development process**: - Topic identification from ticket analysis, user requests, and product updates - Content brief creation (purpose, audience, keywords, outline) - Draft development following style guide - Review by SME for technical accuracy - Editorial review for clarity, completeness, and compliance - Publishing and search index update 2. **Article types and templates**: - How-to guide: step-by-step instructions with screenshots - Troubleshooting: symptom → cause → solution format - FAQ: question and answer format with links to detailed articles - Reference: specification, configuration, compatibility information - Policy: terms, procedures, guidelines - Release notes: new features, bug fixes, known issues 3. **Content optimization**: - SEO optimization: keywords, meta descriptions, URL structure - Readability optimization (Flesch Reading Ease > 60) - Mobile-responsive formatting - Multimedia integration: screenshots, videos, diagrams - Internal linking for content discovery - Translation and localization management ### 3. Search & Discovery 1. **Search engine optimization**: - Full-text search configuration and indexing - Synonym and thesaurus management - Search ranking optimization (relevance scoring, recency boost) - Faceted search and filtering by category, type, product - Popular and trending articles surfacing 2. **Content discovery and navigation**: - Intuitive category and section structure - Breadcrumb navigation and related article suggestions - "Recently viewed" and personalized recommendations - Quick links and featured articles on homepage - Table of contents and page navigation 3. **Search analytics and improvement**: - Search term tracking and zero-result analysis - Search-to-article conversion rate - Most searched topics (content gap identification) - Search result click-through rate - Continuous search optimization based on usage data ### 4. Self-Service Integration 1. **Help center portal design**: - User-friendly portal with search, categories, and featured content - Community forum integration for peer support - Ticket submission option when self-service insufficient - Multi-device responsive design - Accessibility compliance (WCAG 2.1 AA) 2. **Proactive knowledge delivery**: - Contextual help within product/application (in-app KB links) - Chatbot powered by KB content for conversational self-service - Email signature links to relevant KB articles - Automated article suggestions in ticket responses - Proactive notifications for relevant content updates 3. **Deflection and self-service metrics**: - Ticket deflection rate (estimated tickets prevented by KB usage) - Self-service resolution rate - Time savings from self-service vs agent-assisted - KB-assisted resolution rate - Cost savings from deflection ### 5. Content Lifecycle & Continuous Improvement 1. **Content review and refresh**: - Quarterly content audit and freshness check - Automated staleness alerts (articles not updated in 90+ days) - Product change trigger for related article updates - Usage analytics trigger (low-traffic article review) - Feedback-driven content improvement 2. **Feedback and quality measurement**: - Article rating system (helpful/not helpful) - User feedback collection and categorization - Agent feedback on article quality and usefulness - Content quality score by article and author - Community voting and comment moderation 3. **Analytics and reporting**: - Article view counts and engagement metrics - Top articles by views and ratings - Content gap analysis (search terms without results) - Author productivity and quality metrics - KB ROI measurement (deflection, satisfaction, cost savings) ## Templates & Frameworks ### KB Article Template ``` KNOWLEDGE BASE ARTICLE TEMPLATE ================================ TITLE: [Clear, searchable, action-oriented — e.g., "How to Reset Your Password"] APPLIES TO: [Product version, platform, user role] LAST UPDATED: [Date] AUTHOR: [Name] REVIEW DUE: [Date + 90 days] TABLE OF CONTENTS: 1. Overview 2. Prerequisites 3. Step-by-Step Instructions 4. Troubleshooting 5. Related Articles OVERVIEW: [2-3 sentences explaining the purpose and scope of this article] PREREQUISITES: — [Required access, permissions, software, or conditions] STEP-BY-STEP INSTRUCTIONS: 1. [Step one — specific action] [Screenshot or diagram] Expected result: [What the user should see] 2. [Step two — specific action] [Screenshot or diagram] Expected result: [What the user should see] 3. [Step three — specific action] [Screenshot or diagram] Expected result: [What the user should see] TROUBLESHOOTING: Problem: [Issue description] Cause: [Likely cause] Solution: [Steps to resolve] Problem: [Issue description] Cause: [Likely cause] Solution: [Steps to resolve] RELATED ARTICLES: — [Link to related article 1] — [Link to related article 2] — [Link to related article 3] FEEDBACK: Was this article helpful? □ Yes □ No Comments: [User feedback field] ``` ### KB Content Audit Checklist ``` ARTICLE FRESHNESS AUDIT — Monthly Review ========================================== ARTICLE REVIEW CRITERIA: ACCURACY: [ ] Information matches current product/version [ ] Screenshots are current and accurate [ ] Links are valid and point to correct content [ ] Procedures tested and verified COMPLETENESS: [ ] All steps documented with expected results [ ] Common troubleshooting scenarios covered [ ] Edge cases and exceptions documented [ ] Related articles linked CLARITY: [ ] Language clear and concise (Flesch score > 60) [ ] Consistent formatting and structure [ ] Screenshots enhance understanding [ ] No jargon without explanation ENGAGEMENT: [ ] Article has sufficient views to warrant keeping [ ] User rating is above 80% helpful [ ] Low support ticket volume on this topic [ ] Search ranking is adequate ACTION: ✓ Keep as-is ⚠ Update (identify changes needed) 🔴 Rewrite (significant content changes needed) 🗑 Archive/Remove (outdated or redundant) ``` ## Integration Points - KB platforms (Confluence, Guru, Document360, Zendesk Guide, Helpjuice): Content management - ITSM/helpdesk (ServiceNow, Zendesk, Freshservice): Article linking, deflection tracking - CRM platforms: Customer-facing content integration - Product analytics: In-app help integration, usage tracking - Chatbot platforms (Intercom, Drift, Ada): Conversational self-service - Search platforms (Elasticsearch, Swiftype): Advanced search capabilities - Translation services (Crowdin, Lokalise): Multi-language content management - Analytics platforms (Google Analytics, internal analytics): Usage tracking ## Edge Cases - **Rapid product changes**: Establish product change notification workflow; assign article owners per product area; implement "draft update" flag for in-progress articles - **Multi-product knowledge base**: Clear product filtering and navigation; cross-product reference management; dedicated content owners per product line - **High-volume technical documentation**: API documentation auto-generation from code; developer portal separation; community contribution management - **Global/multi-language content**: Professional translation workflow; cultural adaptation per market; local SME review - **Content ownership disputes**: Define clear content ownership matrix; escalation process for ownership conflicts; shared ownership guidelines ## Output ### Knowledge Base Dashboard ``` KNOWLEDGE BASE — April 2025 ============================== CONTENT OVERVIEW: Total articles: 1,247 Internal KB: 834 articles External/help center: 413 articles Last 30 days: 23 new, 47 updated, 5 archived CONTENT FRESHNESS: Up-to-date (updated < 90 days): 1,089 (87.3%) ✓ Needs review (90-180 days): 134 (10.7%) ⚠ Overdue (> 180 days): 24 (1.9%) 🔴 USAGE METRICS: Total views (30 days): 89,400 Avg views per article: 71.7 Search usage: 34,200 searches (38.3% of sessions) Search-to-article rate: 82% Zero-result searches: 12% (content gap opportunities) SELF-SERVICE IMPACT: Estimated ticket deflection: 31% of total volume KB-assisted resolutions: 28% of agent resolutions Avg time saved per deflected ticket: 25 minutes Monthly cost savings (estimated): $18,400 Help center CSAT: 4.2/5.0 CONTENT QUALITY: Avg helpful rating: 89% ✓ Articles rated: 67% of total Top-rated category: Getting Started (94% helpful) Lowest-rated category: Troubleshooting (78% helpful) Feedback requests (30 days): 34 (being addressed) SEARCH INSIGHTS: Top search terms: password reset, integration setup, billing, API documentation Top content gaps: mobile app troubleshooting, third-party integrations Trending topics: [new feature name] — 450 searches this week ```