Skip to content

review-api

review-api finds the exported surface, infers the canonical shape from a few exemplar units, and runs three read-only audits: shape conformance, sibling completeness, and docs versus exports.

  • “review this project for consistency and API completeness”
  • “what is missing from the API?”
  • “are the docs in sync with the exports?”
  • Before a major release, when the surface is about to be frozen.

Run /review-api, or ask in plain words. It takes no arguments.

A priority-ordered report: obvious fixes, design-level drift, sibling-justified gaps, docs issues, and a suggested order of work. It checks every claim against the code before reporting it. The audits run on cheap subagents where the harness supports them.

Propose an API that no existing sibling justifies, report a documented intentional exception as drift, or edit code or file issues on its own. When the report is done it offers to open one issue per section or start the obvious fixes.

Read access to the code. Filing issues afterward needs the host CLI.

/review-api are the docs in sync with the exports?

More detail: skill README.