api-smoke-testing

Q: How do I install api-smoke-testing?

Run npx skills add https://github.com/spencerpauly/awesome-cursor-skills --skill api-smoke-testing in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/api-smoke-testing/ (personal) or .claude/skills/api-smoke-testing/ (project).

by spencerpaulyBackend & APIs

Start the dev server, discover API routes from the codebase, hit every endpoint, and report which ones return errors.

Installs: 500
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/spencerpauly/awesome-cursor-skills --skill api-smoke-testing

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads api-smoke-testing automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

API Smoke Testing

Verify all API endpoints return healthy responses by combining codebase analysis with HTTP requests.

Workflow

1. Discover Routes

Search the codebase for API route definitions:

Next.js (App Router): app/api/**/route.ts Next.js (Pages Router): pages/api/**/*.ts Express: Look for app.get(, app.post(, router.get(, etc. Django: Look for urlpatterns in urls.py FastAPI: Look for @app.get(, @app.post(, decorators Rails: Look for routes.rb

Build a list of endpoints with their HTTP methods.

2. Ensure Server is Running

Check terminal files for a running dev server. If none found, start one.

3. Hit Every Endpoint

For each route:

curl -s -o /dev/null -w "%{http_code}" -X <METHOD> http://localhost:<PORT><PATH>

For endpoints that require a body (POST/PUT/PATCH), send a minimal valid JSON:

curl -s -o /dev/null -w "%{http_code}" -X POST http://localhost:<PORT><PATH> \
  -H "Content-Type: application/json" \
  -d '{}'

4. Classify Results

Status	Meaning
200-299	OK
301/302	Redirect (OK)
400	Bad request (expected for empty POST bodies)
401/403	Auth required (expected for protected routes)
404	Route not found (BUG — route exists in code but not served)
500	Server error (BUG)
000/timeout	Server not responding (BUG)

5. Report

API Smoke Test Results:
  Tested: 15 endpoints
  Passed: 12
  Auth required: 2 (GET /api/user, POST /api/settings)
  Errors:
    500 — POST /api/webhooks/stripe (TypeError: Cannot read property 'id' of undefined)
    404 — GET /api/v2/health (route defined but not mounted)

6. Fix Errors

For 500 errors, read the terminal output for the stack trace and fix the root cause. For 404s, check that the route file is in the correct location and properly exported.

FAQ

What does the api-smoke-testing skill do?

Start the dev server, discover API routes from the codebase, hit every endpoint, and report which ones return errors.

How do I install api-smoke-testing?

Run npx skills add https://github.com/spencerpauly/awesome-cursor-skills --skill api-smoke-testing in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/api-smoke-testing/ (personal) or .claude/skills/api-smoke-testing/ (project).

Which AI agents can use api-smoke-testing?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is api-smoke-testing safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains api-smoke-testing?

It is published by spencerpauly in spencerpauly/awesome-cursor-skills. It has 500 recorded installs.