api-documentation-audit - Audit repository OpenAPI documentation
Audits repository OpenAPI documents for presence, completeness, contracts, responses, schemas, security, and lint/drift wiring, then writes a severity-classified artifact.
Tags
Updated: 2026-09-29Capabilities
Typical Inputs
Typical Outputs
What this skill does
- Discover OpenAPI documents
- Classify audit findings
- Check documentation contracts
- Check response and schema hygiene
- Check security documentation
- Check lint and drift wiring
- Render severity-sorted reports
- Persist audit artifacts
Inputs
- Repository root
- OpenAPI document scope
- Severity floor
- Audit trigger
Outputs
- Severity-classified audit report
- Markdown audit artifact
- Per-document findings
- Per-document verdicts
Requirements
- Read-only repository access
- api-documentation-scanner agent