docs-link-click-analyzerlisted
Install: claude install-skill Docsbook-io/docs-skills
# docs-link-click-analyzer — Find dead CTAs and dead-end pages
Two failure modes this skill catches:
1. **Underperforming CTA** — a button gets impressions but few clicks. Example: `/quick-start` has 30k views, `Sign up` CTA has 60 clicks (0.2%). The CTA is invisible, mislabeled, or the page doesn't earn the click.
2. **Orphan traffic** — a page receives pageviews but no one clicks anything on it. Either the page is a terminal (FAQ-style), or it's a dead end nobody intended.
## When to run
- Weekly during pricing/onboarding experiments.
- Monthly otherwise.
- Whenever site median CTR moves materially.
## Workflow
Standard four-stage docs-insights pipeline. Slice = `link_clicks`. See [`docs-utm-analyzer`](../docs-utm-analyzer/SKILL.md) for canonical step-by-step.
- **Collector:** every click a reader made on a CTA or an outgoing link, grouped by `(source_page, target_label)`, plus per-page traffic totals to serve as impressions. Any other click-level signal on the same pages belongs here.
- **Clusterer:** computes `expected_ctr` = site-wide median CTR of the same CTA label. Flags clusters where CTR < 0.5× expected AND impressions ≥ 200.
- **Reporter:** `cta_underperformance` (high severity for revenue CTAs like Upgrade/Sign up; medium otherwise); `orphan_traffic` for zero-click pages with ≥ 200 pv.
## What this skill catches
| Pattern | Example finding |
|---|---|
| **CTA buried** | `Upgrade` on `pricing-spec.md`: 12k impressions, 160 clicks (1.3% vs site median 4%).