code-review-docs

Audits documentation for accuracy, coverage, structure, and cross-reference issues against a codebase.

5|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/ably/ably-ai-transport-js --skill code-review-docs-ably
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-review-docs
Source: https://github.com/ably/ably-ai-transport-js/tree/main/.claude/skills/code-review-docs
Command: npx skills add https://github.com/ably/ably-ai-transport-js --skill code-review-docs-ably

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill reviews project documentation for accuracy, completeness, structure, and cross-reference quality so teams can catch stale examples, missing coverage, and broken links before users do.

Core Features & Use Cases

  • Documentation Accuracy Review: Checks examples, API signatures, literal values, behaviors, and references against the current implementation.
  • Coverage Audit: Verifies that public exports, options, events, and edge cases are documented where readers expect to find them.
  • Structure and Voice Review: Confirms pages follow the project's documentation patterns, including clear definitions, scannable headings, and consistent tone.
  • Use Case: Review a docs change after a code update to identify anything that became outdated, incomplete, or inconsistent with the source of truth.

Quick Start

Use the code-review-docs skill to audit the selected documentation pages for accuracy, coverage, structure, and cross-reference issues against the current codebase.

Frequently Asked Questions about code-review-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I catch documentation drift after updating my codebase?

You can catch documentation drift by auditing your pages against the codebase to verify API accuracy, public surface coverage, and cross-reference integrity. This identifies outdated examples and missing coverage before users do.

What is a documentation coverage audit for public APIs?

A documentation coverage audit verifies that public exports, options, events, and edge cases are documented where readers expect to find them. It checks that all public surfaces in the codebase have corresponding reader-facing explanations.

How do I check API accuracy and cross-reference integrity in my docs?

To check API accuracy and cross-reference integrity, audit the documentation against the implementation to verify that examples, signatures, literal values, and internal links match the current source of truth without editing the files directly.

Does the documentation review check structure and voice consistency?

Yes, the documentation review checks structure and voice consistency. It confirms that pages follow project documentation patterns, including clear definitions, scannable headings, and a consistent tone throughout the content.

Can I use a documentation review skill without modifying my source files?

Yes, you can audit documentation without modifying source files. The review process verifies accuracy, coverage, structure, and cross-reference quality read-only, flagging issues for you to address without directly editing the files.

What's the best way to review stale examples and broken links in project docs?

The best way to review stale examples and broken links is to run a doc-driven review loop that checks examples, literal values, behaviors, and cross-references against the current implementation to find outdated content before users do.