majiayu000 CE RTD Auditor
Use this skill to perform a critical docs audit across docs/.
Load references/rtd_audit_checklist.md before producing findings.
Audit scope
- changed docs pages
- related index/toctree pages
- linked API and ADR references
- command/code snippet correctness
Workflow
- Identify targets:
rg --files docs
rg -n "{doc}|toctree|WrapCalibratedExplainer|ce_agent_utils" docs
- Validate navigation and discoverability:
- page is included in the appropriate toctree/index
- page title and sectioning are clear and stable
- Validate technical correctness:
- examples use public API (
WrapCalibratedExplainer,ce_agent_utils) - no private-member guidance
- uncertainty semantics and CE-first lifecycle are consistent
- Validate governance alignment:
- ADR and standards references exist and are relevant
- no stale or contradictory policy claims
- Validate links and references:
- internal
{doc}targets resolve - markdown links point to real pages/files
Output contract
Return findings first, ordered by severity:
- blocker
- high
- medium
- low
Each finding must include:
- path + line reference
- issue summary
- impact
- precise fix recommendation
Constraints
- Do not propose evaluation-specific skill expansion.
- Prioritize user-facing correctness over wording-only edits.