audit-api-consistency
Installation
SKILL.md
Audit API Consistency
Overview
Scan the codebase for API route definitions and analyze them for consistency across naming, HTTP method usage, error response shapes, pagination, auth patterns, and versioning. Produce a structured report with severity-rated findings and concrete fix recommendations. This is an audit skill -- it analyzes what exists, it does not create new APIs.
Workflow
- Read project context -- Read
.chalk/docs/engineering/for:- Existing API design documents that define the intended conventions
- Architecture docs describing the API layer
- Any API style guides or conventions documents
- Prior audit reports to check if previously flagged issues were resolved