Skip to content
Skills Library
Programming · Building & coding

quick-api

/quick-api

Use when scaffolding a new API endpoint — types, test, handler, validation, route, docs

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

  1. Step 1: Detect Framework
  2. Step 2: API Contract (Types First)
  3. Step 3: Write Test First
  4. Step 4: Checkpoint
  5. Step 5: Implement Handler
  6. Step 6: Register Route
  7. Step 7: Verify
  8. 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.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.