IT AI Skill

Knowledge Base Management

Manage IT knowledge bases including article creation, categorization, search optimization, self-service deflection, and continuous improvement. Use when building KB articles, implementing self-service portals, measuring KB effectiveness, or optimizing knowledge management processes. Triggers on phrases like "knowledge base", "KB article", "self-service", "deflection rate", "knowledge management", "KB taxonomy", "article quality", "search optimization", "KB analytics", "community forums", "knowledge sharing", "documentation", "runbook", "playbook".

Knowledge Base Management

Manage IT knowledge bases including article creation, self-service portals, search optimization, and continuous improvement.

Workflow

1. KB Architecture & Taxonomy

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

CATEGORY: Infrastructure
  Subcategory: Servers
    → Windows Server management
    → Linux administration
    → Virtualization (VMware, Hyper-V)
    → Container orchestration
  Subcategory: Network
    → VPN setup and troubleshooting
    → DNS resolution issues
    → Firewall configuration
    → Wi-Fi connectivity

CATEGORY: Applications
  Subcategory: Email
    → Exchange administration
    → Outlook configuration
    → Shared mailbox management
  Subcategory: Collaboration
    → Teams/Slack administration
    → SharePoint management
    → Document management

CATEGORY: End User Support
  Subcategory: Hardware
    → Laptop setup and configuration
    → Printer issues
    → Peripheral devices
  Subcategory: Software
    → Office 365 troubleshooting
    → Application installation
    → License activation

CATEGORY: Security
  Subcategory: Account Management
    → Password reset procedures
    → MFA enrollment and issues
    → Account lockout resolution
  Subcategory: Compliance
    → Data handling procedures
    → Security incident reporting
    → Policy documentation

ARTICLE TEMPLATE:
═══════════════════════════════════════

Title: [Clear, searchable problem statement]
Category: [Primary category]
Subcategory: [Specific area]
Tags: [5-10 searchable keywords]
Type: How-to / Troubleshooting / FAQ / Runbook / Policy

Symptom/Problem: [What the user is experiencing]
Cause: [Root cause of the issue]
Solution: [Step-by-step resolution]
  Step 1: ...
  Step 2: ...
  Step 3: ...
Prevention: [How to avoid this issue]
Related Articles: [Links to relevant KBs]
Last Updated: [Date]
Author: [Name]
Reviewed By: [Reviewer name]

2. Article Lifecycle Management

KNOWLEDGE ARTICLE LIFECYCLE
═══════════════════════════════════════

Stage 1: CREATE
═══════════════════════════════════════

  Trigger:
    → Recurring ticket pattern (>3 similar tickets in 30 days)
    → New product/service documentation
    → Incident post-mortem lessons
    → Customer feedback / support request

  Creation:
    → Author drafts article using template
    → Includes: screenshots, videos, command examples
    → Tags with searchable keywords
    → Links related articles

Stage 2: REVIEW
═══════════════════════════════════════

  Review checklist:
    → Technical accuracy verified
    → Steps tested and validated
    → Screenshots current and clear
    → Links functional
    → Accessibility compliant (WCAG)
    → Language clear (8th grade reading level)
    → Mobile-friendly formatting

  Approval:
    → Peer review (subject matter expert)
    → Editor review (clarity, format)
    → Published after dual approval

Stage 3: PUBLISH & PROMOTE
═══════════════════════════════════════

  → Publish to self-service portal
  → Add to suggested articles for related tickets
  → Share in relevant channels (Slack, Teams)
  → Surface in portal search
  → Link from email signatures (for support team)

Stage 4: MAINTAIN
═══════════════════════════════════════

  → Quarterly review of all articles
  → Update when products/processes change
  → Track usage metrics (views, helpfulness)
  → Retire outdated content
  → Merge duplicate articles

Stage 5: RETIRE
═══════════════════════════════════════

  Criteria:
    → Product/service discontinued
    → Superseded by new article
    → No views in 6+ months
    → Accuracy cannot be verified

3. Self-Service & Deflection

SELF-SERVICE PORTAL DESIGN
═══════════════════════════════════════

Portal Features:
═══════════════════════════════════════

  1. Intelligent Search:
     → Natural language processing (understands "can't print")
     → Autocomplete suggestions
     → Synonym matching ("login" = "signin" = "access")
     → Filter by category, type, date

  2. Popular Articles (Homepage):
     → Top 10 viewed articles
     → Trending articles (last 7 days)
     → Recently updated articles

  3. Suggested Articles (Ticket Creation):
     → Show related KB articles before ticket form
     → "Did this help?" prompt with yes/no
     → If yes: Log as deflected, don't create ticket
     → If no: Allow ticket creation with article reference

  4. Community Forum:
     → User-to-user Q&A
     → Upvoted answers
     → Expert badges

DEFLECTION METRICS:
═══════════════════════════════════════

  Metric                          Current    Target
  ──────────────────────────────────────────────────
  Self-service deflection rate    35%        50%
  KB article views/month          15,000     25,000
  "Helpful" rating                78%        85%
  Avg resolution (self-service)   3 min      2 min
  Tickets deflected by KB         1,200/mo   2,000/mo
  Cost per deflected ticket       $0 (vs $25)

DEFLECTION ANALYSIS:
═══════════════════════════════════════

  Top deflected issues:
  1. Password reset: 450/month (solved via self-service password reset)
  2. Printer setup: 280/month (video tutorial + driver download)
  3. Email configuration: 220/month (auto-config guide)
  4. Software installation: 150/month (catalog + approval workflow)
  5. VPN connection: 100/month (troubleshooting wizard)

4. KB Analytics & Quality

KNOWLEDGE BASE ANALYTICS
═══════════════════════════════════════

USAGE ANALYTICS:
═══════════════════════════════════════

  Article Performance (Top 10):
  ════════════════════════════════════════

  Rank  Article                           Views    Helpfulness   Deflections
       ──────  ─────────────────────────   ─────    ───────────   ───────────
  1     How to reset your password        2,400    92%           890
  2     Printer not connecting            1,800    78%           520
  3     Set up email on mobile            1,500    85%           610
  4     Teams audio not working           1,200    72%           340
  5     Install software from catalog      900     88%           420
  6     VPN connection failed              800     70%           280
  7     Outlook calendar sync issues       700     65%           180
  8     Screen sharing on Teams            650     82%           310
  9     Request new hardware               600     90%           0*
  10    Change display resolution          500     75%           220
  * = request form, not deflection

SEARCH ANALYTICS:
═══════════════════════════════════════

  Zero-result searches (content gaps):
    → "Teams recording download" — 45 searches, 0 results → CREATE ARTICLE
    → "Excel macro not working" — 32 searches, 0 results → CREATE ARTICLE
    → "SharePoint permission denied" — 28 searches, 0 results → CREATE ARTICLE
    → "Zoom background blur" — 22 searches, 0 results → CREATE ARTICLE

  Missed searches (article exists but not found):
    → "Can't log in" → Article titled "Troubleshooting Login Issues"
      → Add synonyms: "can't log in", "can't sign in", "login fails"
    → "My computer is slow" → Article titled "Performance Optimization Guide"
      → Add synonyms: "computer slow", "pc slow", "slow performance"

QUALITY METRICS:
═══════════════════════════════════════

  Article Quality Score (AQS):
    → Helpfulness rating: 40%
    → View-to-ticket ratio: 30%
    → Content freshness: 15%
    → Completeness (template fields): 15%

  Overall AQS: 76/100 (Target: 80+)

5. KB Governance

KNOWLEDGE GOVERNANCE FRAMEWORK
═══════════════════════════════════════

ROLES AND RESPONSIBILITIES:
═══════════════════════════════════════

  Knowledge Owner: VP IT (overall accountability)
  Knowledge Manager: Manages KB strategy, quality, governance
  Subject Matter Experts: Authors and reviews in their domain
  Tier 1/2 Support: Create articles from recurring tickets
  End Users: Rate articles, submit feedback, community contributions

QUALITY ASSURANCE:
═══════════════════════════════════════

  Monthly:
    → Review top articles for accuracy
    → Identify content gaps (zero-result searches)
    → Track deflection rate trends
    → Review "not helpful" ratings

  Quarterly:
    → Full article audit (freshness, accuracy)
    → Merge/retire duplicate or outdated articles
    → Survey support staff for KB usability
    → Report to leadership on KB effectiveness

  Annually:
    → Taxonomy review and restructuring
    → Platform evaluation (upgrade/migrate)
    → Benchmarking against industry standards

Edge Cases

Multilingual KB: Translate articles, maintain quality across languages
Regulated industries: KB articles as controlled documents (versioning, approval)
Large scale: 10,000+ articles require AI classification and deduplication
Community content: Moderation workflow for user-generated articles
Video KB: Screen recordings, step-by-step videos with transcripts

Integration Points

Service desk: ServiceNow, Jira Service Management, Freshservice
Search: Elasticsearch, Algolia, Azure Cognitive Search
Analytics: Google Analytics, custom dashboards
Authoring: Confluence, SharePoint, Markdown editors
AI: NLP for search, chatbot for article suggestion
Collaboration: Teams, Slack (KB sharing)

Output

KB Status Report

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

Articles: 850 (active), 120 (retired)
Monthly views: 15,000
Deflection rate: 35% (target: 50%)
Average helpfulness: 78%

Content gaps identified: 4 (articles in progress)
Quality score: 76/100 (target: 80+)

Top action: Create articles for top 4 zero-result searches

Disclaimer: All rights reserved by Circulos AI. These skills are specifically designed for Claude Code, Claude Cowork, Codex, and OpenClaw. When using or referencing any skill, please provide proper attribution to Circulos AI.