gabrielmoreira 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.