api-endpoint

Generate API endpoint scaffolds with validation, auth hooks, and tests.

11|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/berkcangumusisik/claude-code-practices --skill api-endpoint-berkcangumusisik
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-endpoint
Source: https://github.com/berkcangumusisik/claude-code-practices/tree/main/skills/api-endpoint
Command: npx skills add https://github.com/berkcangumusisik/claude-code-practices --skill api-endpoint-berkcangumusisik

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the creation of a complete API endpoint, including input validation, error handling, and automated tests, reducing boilerplate and ensuring consistency.

Core Features & Use Cases

  • Framework-agnostic endpoint scaffolding with request validation, authentication hooks (if the project uses auth), and clear error handling.
  • Automatic route registration and test generation for common success and error scenarios.
  • Use Case: When adding a new resource, generate a ready-to-run endpoint and tests with minimal changes.

Quick Start

Provide the method and path, plus a brief description, and this skill will scaffold the route, tests, and docs.

Frequently Asked Questions about api-endpoint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold API endpoints with validation and tests automatically?

To scaffold API endpoints with validation and tests, provide the HTTP method, path, and a brief description. The tool identifies your project framework from package.json and existing routes, then generates a route handler, validation schema, auth hooks, and error handling.

What is the best way to generate consistent route handlers across different frameworks?

Generating consistent route handlers across different frameworks requires framework-agnostic scaffolding. This skill detects your framework from package.json and existing routes, then produces a consistent route handler, validation schema, and error handling tailored to your project structure.

Can I automatically create tests covering validation errors and edge cases for new API routes?

Yes, you can automatically create tests covering validation errors and edge cases for new API routes. The scaffolding process generates automated tests that cover the happy path, validation errors, and edge cases alongside the route handler.

Does the API endpoint scaffolding work with my existing project framework?

API endpoint scaffolding works with your existing project framework by performing framework detection. It reads your package.json and analyzes existing routes to ensure the generated endpoint scaffold, validation schema, and router registrations match your current setup.

How do I add authentication hooks to newly scaffolded API endpoints?

To add authentication hooks to newly scaffolded API endpoints, the tool checks if your project uses auth during generation. It then integrates the appropriate auth hooks directly into the route handler scaffold alongside input validation and error handling.

Why do I need to scaffold endpoints instead of writing route handlers manually?

You need to scaffold endpoints instead of writing route handlers manually to reduce boilerplate and ensure consistency. Automated scaffolding produces a complete endpoint with input validation, error handling, and tests, minimizing manual changes when adding new resources.