api-audit

Audit API endpoints for naming, response shape, validation, and authentication issues.

2|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/hamzaPixl/pixl-ai --skill api-audit-hamzapixl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-audit
Source: https://github.com/hamzaPixl/pixl-ai/tree/main/packages/crew/skills/api-audit
Command: npx skills add https://github.com/hamzaPixl/pixl-ai --skill api-audit-hamzapixl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The api-audit skill automates discovery and review of HTTP endpoints to surface inconsistent naming, untyped or mismatched response shapes, missing input validation, and authentication or authorization gaps so teams can prioritize fixes.

Core Features & Use Cases

  • Multi-framework discovery: Detects routes in Fastify, Express, FastAPI, and Next.js projects and inventories methods, paths, handlers, auth, validation, and response typing.
  • Conformance checks: Validates REST naming conventions, method–path alignment, versioning, and parameter naming consistency.
  • Security and validation audits: Identifies missing input schemas (Zod/Joi/Pydantic), unprotected endpoints, inconsistent auth requirements, and rate-limit blind spots.
  • Scorecard & remediation: Produces a prioritized scorecard with critical issues, warnings, and actionable suggestions for naming, responses, validation, and auth.
  • Use Case: Run against a monorepo API to produce a remediation plan before a public release or security review.

Quick Start

Use the api-audit skill to scan the project's routes directory and produce a prioritized API audit report.

Frequently Asked Questions about api-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit API endpoints for missing validation and auth issues?

You can audit API endpoints across multiple frameworks to detect missing input validation schemas and unprotected authentication middleware. The scan inventories route handlers and applies conformance checks to surface security gaps and inconsistent auth requirements.

Can I use this to scan FastAPI and Express routes for REST naming inconsistencies?

Yes, you can scan FastAPI, Express, Fastify, and Next.js API routes to validate REST naming conventions and method-path alignment. The audit extracts route metadata to detect parameter naming inconsistencies and versioning issues across your endpoints.

What is included in an API health scorecard for remediation planning?

An API health scorecard includes a prioritized list of critical issues, warnings, and actionable suggestions for naming, response shapes, validation, and authentication. It scores overall API health by evaluating extracted route metadata and detected middleware.

How do I check for unprotected endpoints before a public API release?

Check for unprotected endpoints by running an audit to identify missing auth middleware and inconsistent authorization requirements across your route handlers. The scan produces a prioritized remediation plan highlighting security gaps and rate-limit blind spots before release.

Does the audit work with Zod and Pydantic validation schemas?

Yes, the audit works with Zod, Joi, and Pydantic validation schemas to identify missing input schemas across your API endpoints. It detects these validation frameworks during route metadata extraction to ensure conformance and surface untyped response shapes.

What are common API design flaws found during an endpoint inventory?

Common API design flaws found during an endpoint inventory include inconsistent naming conventions, untyped or mismatched response shapes, missing input validation schemas, and authentication or authorization gaps. The audit surfaces these issues to help prioritize fixes.