Does it support role-based access control?

Yes, it provides a specific middleware stack including role requirements (guest, user, admin) and 'isOperatingOnSelf' logic for user-specific resources.

What are the mocking rules for tests?

Only external boundaries like 3rd-party APIs, AWS, or email services should be mocked. Never mock internal services, database calls, or library functions.

What testing framework does this skill support?

It follows an integration testing philosophy using Mocha and Supertest, focusing on testing real behavior through the full stack without mocking internal services.

How are URL routes structured?

Routes use the /v1/ prefix, kebab-case (e.g., /audio-blocks), and plural nouns (e.g., /users) to maintain RESTful standards.

How does it handle API documentation?

It guides you to create OpenAPI 3.0 spec files ([module].api.docs.yaml) which are auto-discovered and served as a Swagger JSON file.

REST API Endpoint Architect

Name: REST API Endpoint Architect
Author: briankeane

bybriankeane

0•

API 开发

Standardizes the creation of REST API endpoints with integrated testing, OpenAPI documentation, and security middleware.

The create-endpoint skill provides a rigorous, step-by-step workflow for developing production-grade REST API endpoints within the node-react-scaffold environment. It enforces a test-driven development (TDD) approach using integration tests that verify full-stack behavior without internal mocking. The skill guides developers through a standardized middleware stack—covering authentication, UUID validation, and role-based access control—while ensuring that every new endpoint is automatically documented via OpenAPI 3.0. By following these patterns, developers can maintain a consistent, secure, and highly maintainable backend architecture.

主要功能

01Standardized kebab-case and plural noun URL structures

02Test-Driven Development (TDD) workflow for API routes

03Automated OpenAPI 3.0 documentation generation

04Pre-configured middleware stack for auth and validation

050 GitHub stars

06Strict integration testing rules with zero internal mocking

使用场景

01Building secure, role-protected resources for a Node.js backend

02Implementing standardized error handling and status codes across an API

03Generating comprehensive Swagger documentation for frontend consumers

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add briankeane/node-react-scaffold create-endpoint

For use in Claude.ai and ChatGPT

主要功能

01Standardized kebab-case and plural noun URL structures

02Test-Driven Development (TDD) workflow for API routes

03Automated OpenAPI 3.0 documentation generation

04Pre-configured middleware stack for auth and validation

050 GitHub stars

06Strict integration testing rules with zero internal mocking

使用场景

01Building secure, role-protected resources for a Node.js backend

02Implementing standardized error handling and status codes across an API

03Generating comprehensive Swagger documentation for frontend consumers

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add briankeane/node-react-scaffold create-endpoint

For use in Claude.ai and ChatGPT