audit-api-consistency
Audit existing API endpoints for consistency when the user asks to check API quality, review API patterns, audit endpoints, or find API inconsistencies
npx skills add majiayu000/claude-skill-registry --skill audit-api-consistency --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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 1. **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 2. **Discover route definitions** -- Scan the codebase to find all API endpoints: - Use Grep to search for route registration patterns: - Express/Koa: `router.get`, `router.post`, `app.use`, etc. - Django: `path(`, `url(`, `@api_view` - Spring: `@GetMapping`, `@PostMapping`, `@RequestMapping` - FastAPI: `@app.get`, `@router.post` - Rails: `resources :`, `get '`, `post '` - Next.js: files in `app/api/` or `pages/api/` - Build a complete inventory of endpoints with: method, path, handler file, and
- Overview
- Workflow
- Consistency Categories
- 1. URL Naming Patterns
- 2. HTTP Method Usage
- 3. Error Response Format
- 4. Pagination Approach
- 5. Authentication and Authorization
- 6. Versioning
- 7. Response Envelope
- Report Format
- Scanning Strategy
- Anti-patterns
What does the audit-api-consistency skill do?
Audit existing API endpoints for consistency when the user asks to check API quality, review API patterns, audit endpoints, or find API inconsistencies
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill audit-api-consistency --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.