Agent skill · software engineering · sickn33

api-endpoint-builder

Builds production-ready REST API endpoints with validation, error handling, authentication, and documentation. Follows best practices for security and scalability.

Why this skill is useful

Provides specific implementation patterns for building REST APIs with validation and error handling that the AI wouldn't reliably generate on its own.

What it needs

About 4k tokens when loaded. Last updated 2026-08-07. 44,571 stars on the source repository.

What this skill does

API Endpoint Builder Build complete, production-ready REST API endpoints with proper validation, error handling, authentication, and documentation. When to Use This Skill User asks to "create an API endpoint" or "build a REST API" Building new backend features Adding endpoints to existing APIs User mentions "API", "endpoint", "route", or "REST" Creating CRUD operations What You'll Build For each endpoint, you create: Route handler with proper HTTP method Input validation (request body, params, query) Authentication/authorization checks Business logic Error handling Response formatting API documentation Tests (if requested) Endpoint Structure 1. Route Definition 2. Input Validation Always validate before processing: 3. Handler Implementation Best Practices HTTP Status Codes 200 - Success (GET, PUT, PATCH) 201 - Created (POST) 204 - No Content (DELETE) 400 - Bad Request (validation failed) 401 - Unauthorized (not authenticated) 403 - Forbidden (not authorized) 404 - Not Found 409 - Conflict (duplicate) 500 - Internal Server Error Response Format Consistent structure: Security Checklist [ ] Authentication required for protected routes [ ] Authorization checks (user owns resource) [ ] Input validation on all fields [ ] SQL injection prevention (use parameterized queries) [ ] Rate limiting on public endpoints [ ] No sensitive data in responses (passwords, tokens) [ ] CORS configured properly [ ] Request size limits set Error Handling Common Patterns CRUD Operations Pagination Filtering & Sorting Documentation Template Testing Example Key Principles Validate all inputs before processing Use proper HTTP status codes Handle errors gracefully Never expose sensitive data Keep responses consistent Add authentication where needed Document your endpoints Write tests for critical paths Related Skills @security-auditor - Security review @test-driven-development - Testing @database-design - Data modeling Limitations Use this skill only when the task clearly matches the scope descri …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills sickn33/api-endpoint-builder--78741e

View the source on GitHub

Browse the @skills marketplace