- Home
- Skills
- Code Quality & Review
- API Architect — Free Starter
Works with the AI tools you already use
API Architect — Free Starter
A 12-point rigorous audit for API endpoints to catch permanent design mistakes before they ship.
Free
API Architect — Free Starter
Example session with this skill installed
Review this endpoint: POST /v1/orders. It takes a customer_id and a list of items. Returns 200 on success. No pagination or idempotency keys mentioned in the draft.
- Read your context and instructions
- Compiled the api architect
- Generated the UI component
API REVIEW: POST /v1/orders — verdict: redesign
Fails: 6 (no pagination), 7 (missing idempotency), 3 (failure cases unspecified), 11 (no examples)
Flags: 8 (timestamps not defined)
The one fix that matters most: Define idempotency keys to prevent duplicate orders.
api-architect-free-gateway.tsx
TSX · React component
Example file from a real run - the skill writes it into your workspace.
Connects securely to your tools. The creator never sees your data.
About this skill
The problem
API mistakes become permanent the moment a consumer depends on them. Most developers rely on vibes during code reviews rather than a rigorous standard for naming, error handling, and future-proofing.
What it does
- Evaluates endpoints against 12 critical design questions covering idempotency, pagination, and naming.
- Identifies specific failures in error response shapes and status codes.
- Verifies if types, units, and timezones are explicitly defined rather than implied.
- Provides a structured verdict card with a single "must-fix" priority and a clear ship/fix/redesign status.
- Automatically degrades to a core 4-point check when only a route name is provided.
Why this beats prompting it yourself
This skill enforces evidence-based reviews over intent-based assumptions. It prevents "rubber-stamping" by requiring specific evidence for every pass and triggers a redesign verdict automatically if more than three core failures are detected.
Use cases
- Run a final gate check on a pull request before merging API changes.
- Audit existing legacy endpoints to document technical debt and breaking changes.
- Validate new API designs during the RFC or contract-drafting phase.
- Standardize API review quality across a distributed engineering team.
Known limitations
Requires a design, contract, or diff for a full 12-point audit. If only a route name is provided, it can only perform a partial assessment.
How to install
Works the same in every agent - Claude, Cursor, Codex, Copilot and 20+ more.
- 1
Download the ZIP
Free skills download straight away. Paid skills unlock right after purchase.
- 2
Unzip into your skills folder
Every agent reads skills from one folder on your machine. Drop the unzipped folder in there.
- 3
Ask your agent to use it
Restart the agent if it was already running. It picks the skill up automatically - no config needed.
Skills folder by agent
Click the path to copy it. Create the folder if it does not exist yet.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill passes our trust checks below.
Security scanned
Passed our 8-point scan before listing
3 installs
Downloaded by developers to date
Free forever
No account required to browse
Trust & safety
Security scanned
Verified clean 1 month ago
- Free to download with an account
Needs access to