← ClaudeAtlas

cx-article-effectivenesslisted

Use to measure which help articles actually resolve contacts versus merely being read, including contact-after-view and assisted resolution. Trigger for "are our help articles working", article view counts misleading, deflection measurement, contact after reading an article, self-service success metrics, KB ROI, or stopping AI agents from optimising for page views.
rulebase-co/rulebase-skills · ★ 1 · AI & Automation · score 72
Install: claude install-skill rulebase-co/rulebase-skills
# Measuring article effectiveness View counts are the most dangerous metric in self-service. **A high-traffic article that precedes a contact is a failure, not a success** — customers read it, did not get what they needed, and wrote in anyway. Teams celebrate the traffic; the contact rate tells the truth. The question is not "did they read it?" It is **"did reading it remove the need to contact?"** ## Views are not resolution | Metric | What it actually measures | What it cannot tell you | | --- | --- | --- | | Page views | Exposure | Whether the problem was solved | | Time on page | Engagement (ambiguous) | Whether they found the answer or gave up | | Search clicks | Findability | Whether the destination helped | | Helpful votes | Sentiment of readers who bother | Selection bias; no contact linkage | | Deflection rate (platform) | Vendor-defined, often optimistic | Methodology varies; rarely auditable | An article can have high views because it ranks well, because the title promises something it does not deliver, because agents link it habitually, or because the bot surfaces it before handoff. **None of those imply resolution.** ## Core effectiveness signals Build analysis from conversation exports linked to article events. Exact event names vary by platform; the logic does not. **1. Contact-after-view (CAV).** Customer viewed article A, then opened a ticket on the same topic within a defined window (typically 24–72 hours, same session where possible). **CAV rate = c