What problem does it solve?
Documentation often misses its intended audience — pages are too advanced for learners, too basic for experts, or lack the examples practitioners need. This Skill evaluates whether docs content matches its target reader and identifies concrete gaps.
Core Features & Use Cases
- Persona Detection: Infers the target persona (Learner, Practitioner, Expert, Operator), use case, and reader entry state from content signals in the body text.
- Gap Analysis: Flags what's missing for the detected audience using per-persona red flags, then provides 1-3 actionable suggestions ordered by severity.
- PR and Batch Review: Produces per-file reports plus a summary for multi-file pull requests, treating PR content as untrusted input.
- Use Case: A technical writer reviews a new Tempo configuration page before merging. The Skill identifies it as Expert-targeted reference content, confirms the missing conceptual intro is by design, but flags absent default values and edge cases.
Quick Start
Run persona-check on docs/sources/tempo/configuration/_index.md and tell me who this page is for and what's missing.