Programming · Building & coding
quick-api
/quick-api
Use when scaffolding a new API endpoint — types, test, handler, validation, route, docs
For whom
- Author
- keiseilab ↗
- Repository
- keiseikit ↗
- Licence
- Apache-2.0
- Last repository change
- 19.07.2026
Assessment and security
100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
Deprecation
No signals detected. Repository changed on 19.07.2026, without references to retired models or APIs.
Licence
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
What it does and when to use it
Use when scaffolding a new API endpoint — types, test, handler, validation, route, docs
Original author description
Use when scaffolding a new API endpoint — types, test, handler, validation, route, docs
How it works
- Step 1: Detect Framework
- Step 2: API Contract (Types First)
- Step 3: Write Test First
- Step 4: Checkpoint
- Step 5: Implement Handler
- Step 6: Register Route
- Step 7: Verify
- Step 8: Commit
Original SKILL.md headings · 45 lines, 233 words
SKILL.md preview
---
name: quick-api
description: Use when scaffolding a new API endpoint — types, test, handler, validation, route, docs
disable-model-invocation: true
arguments:
- name: endpoint
description: "Endpoint description, e.g. 'POST /api/users — create user'"
required: true
---
# Quick API Scaffold Workflow
## Step 1: Detect Framework
- Auto-detect from project:
- Python: FastAPI (main.py, routers/), Flask, Django
- JS/TS: Next.js (app/api/), Express, Hono
- Go: net/http, gin, echo
- Find existing endpoint examples to match patterns
## Step 2: API Contract (Types First)
- Define request/response types BEFORE implementation
- Place types where project keeps them (types/, schemas/, models/)
- Include validation rules in type definitions
- Document in OpenAPI format if project uses it
## Step 3: Write Test First
- Create test file matching project conventions
- Test cases:
- Happy path (valid request → expected response)
- Validation error (invalid input → 400/422)
- Auth error if endpoint requires auth (no token → 401)
- Not found if applicable (→ 404)
## Step 4: Checkpoint
- `checkpoint: before quick-api $endpoint`
## Step 5: Implement Handler
- Follow existing handler patterns exactly
- Input validation using project's validation approach
- Error handling matching existing patterns
- Keep handler thin — business logic in service layer if project uses one
## Step 6: Register Route
- Add route in the project's routing configuration
- Match URL pattern, middleware, and auth guards from existing routes
## Step 7: Verify
- Run tests — all pass
- Test manually with curl if appropriate
- Check that OpenAPI/Swagger docs update if auto-generated
## Step 8: Commit
- `feat: add $endpoint endpoint`
Versions
The database has no other skills named quick-api.
Database snapshot: 13.11.2026 · package version 56e2ac2572fb (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90add-api-endpoint
Use when a ticket asks to add or extend an HTTP/API endpoint — a new route, handler, or RPC method — with request validation and a defined response. Invoke for "add a POST /things endpoint", "expose a list API", or "add a field to the X response". - 100generate-route
Scaffold a new AI generation route using createGenerationHandler. Creates route file, adds pricing entry, adds integration test. Use when adding a new /api/generate/* endpoint. - 100add-v1-endpoint
Add a new route under /v1/... to the AerolVM HTTP server. Walks through DTOs, handler, route registration, service-layer call, tests, and the idempotency check. Use when the user asks to "add a v1 endpoint", "add an API route", "add a new HTTP handler", or describes a new… - 90api-endpoint
Use when creating an API endpoint or HTTP route handler — detects the project stack and routes to the matching carve-out (laravel-api-endpoint, nextjs-patterns, symfony-workflow). - 100batch-request-handler
Manage batch request handler operations. Auto-activating skill for API Integration. Triggers on: batch request handler, batch request handler Part of the API Integration skill category. Use when working with batch request handler functionality. Trigger with phrases like "batch… - 100document-api-endpoint
Use when reconciling an API endpoint''s generated OpenAPI schema and declared response types with its actual runtime response. Not for general API documentation: use docs-and-adrs.