api-surface-audit

Verifies higher-level hygiene of the zod-nest public API surface — the kinds of issues that tsc and eslint don't flag because they're consistency / coverage concerns rather than type / syntax errors.

Assumes npm run typecheck and npm run lint are already green. This skill doesn't re-do what those tools already catch (missing imports, broken re-exports, type mismatches, lint violations). Run them first.

When to invoke

• Before cutting a release. A clean audit = the surface ships consistently.
• After adding or renaming a public export. Catches missing tests and convention drift at PR time, not at release.
• After refactoring a module. Verifies per-area re-exports are still serving a purpose (no orphans).
• When reviewing a PR that touches src/index.ts or any src/*/index.ts. The diff alone doesn't show convention adherence or test coverage.

Output contract

A markdown checklist of diagnostics, grouped into 4 categories. Each item carries a path:line anchor and a short proposed fix. If every category is clean, the report is a single ✅ Public API surface clean line.