mohitagw15856/kb-audit

Knowledge Base Audit Skill

A help center silently rots: articles go stale, gaps let tickets through, duplicates confuse search, and nobody notices until deflection drops. This skill audits it — scoring health, mapping gaps against your actual top ticket drivers (so you write what reduces volume, not what's easy), and flagging stale/ duplicate/unfindable content — then hands back a prioritised backlog of what to fix and create.

Required Inputs

Ask for these only if they aren't already provided:

• The KB — the article list/structure (titles, sections; or a sample if large).
• Top ticket drivers — the most common support topics/questions (the single most useful input — it's what should be documented).
• Signals if available — article views, search terms with no results, "was this helpful?" ratings, last-updated dates.
• The goal — reduce ticket volume, improve self-serve, onboard a new product area?

Output Format

KB Audit: [help center]

1. Health scorecard — a quick read across: coverage (are top topics documented?), freshness (how much is stale), findability (titles/search-friendly?), quality (answer-first, scannable?), structure (organised, no duplication). RAG per dimension.

| Dimension | Status | Note | |---|---|---|

2. Coverage gaps (priority) — cross-reference top ticket drivers against existing articles. The gaps where high ticket volume meets no/poor article = the highest-ROI things to write. Rank them.

3. Fix list — existing articles that are stale (outdated steps/screenshots), duplicate/overlapping (consolidate — they split search authority), hard to find (bad title, missing search terms), or low-quality (answer buried, not scannable).

4. Prioritised backlog — combine create + fix, ranked by ticket-deflection impact × effort:

| # | Action (create/fix/merge) | Article/topic | Why (impact) | Effort | |---|---|---|---|---|

5. Quick wins — the 3–5 highest-impact, lowest-effort items to do first (often: fix the title on a high-traffic article, write the one missing top-driver doc).

Quality Checks

• [ ] Gaps are driven by actual top ticket drivers, not guesswork (write what deflects volume)
• [ ] Scorecard covers coverage, freshness, findability, quality, and structure
• [ ] Stale, duplicate, and low-findability articles are specifically flagged
• [ ] The backlog is prioritised by deflection impact × effort, not alphabetically
• [ ] Quick wins are separated out so there's an obvious place to start

Anti-Patterns

• [ ] Do not prioritise by what's easy to write — prioritise by what deflects the most tickets
• [ ] Do not ignore duplicates — overlapping articles split search ranking and confuse users; merge them
• [ ] Do not treat all gaps equally — a gap on a top-5 ticket driver outranks ten niche ones
• [ ] Do not skip findability — a perfect article with a bad title that no one finds deflects nothing
• [ ] Do not audit without the ticket data if it exists — it's the map of what actually matters

Based On

Knowledge-base / support-content practice — ticket-driver-led gap analysis, content health scoring, deflection-impact prioritisation.