One-click install
npx skills add https://github.com/dobachi/claude-skills-marketplace --skill web-api-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: web-api-dev
Source: https://github.com/dobachi/claude-skills-marketplace/tree/main/plugins/web-api-dev/skills/web-api-dev
Command: npx skills add https://github.com/dobachi/claude-skills-marketplace --skill web-api-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you design and implement secure, well-documented RESTful APIs that behave reliably under real production constraints.

Core Features & Use Cases

  • Production-ready REST API design with consistent resource-oriented URLs, stateless behavior, and clear error contracts.
  • OpenAPI 3.0 compliant documentation plus request/response examples and a deliverable-focused endpoint spec.
  • Security, testing, and performance guardrails including RBAC, JSON error formatting, high test coverage expectations, and latency/availability targets.

Quick Start

Ask the skill to produce a full production endpoint spec and implementation plan for a REST API (including OpenAPI 3.0 documentation), with RBAC security, JSON error handling, and unit + integration + e2e test coverage for both success and failure cases.

Frequently Asked Questions about web-api-dev

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

FAQPage Schema
How do I design a production-grade REST API with OpenAPI 3.0 documentation?

To design a production-grade REST API, define resource-oriented URLs, stateless behavior, and JSON request/response schemas, then generate OpenAPI 3.0 compliant documentation with examples and a complete endpoint specification.

How do I implement RBAC security for RESTful API endpoints?

Implement RBAC security by defining role-based access control rules across your CRUD endpoints, ensuring robust input validation, sanitization, and unified JSON error catalogs for unauthorized access scenarios.

What is the best way to format JSON error responses for a REST API?

The best way to format JSON error responses is to use a unified JSON error catalog that standardizes error structures across common failure scenarios, ensuring consistent contracts and clear communication of issues.

How do I structure testing coverage for a REST API including success and failure cases?

Structure REST API testing by implementing unit, integration, and end-to-end (e2e) test coverage that validates both success and failure cases, meeting high coverage expectations for reliable production behavior.

Can I define latency and availability performance targets for my REST API endpoints?

Yes, you can define performance and availability targets for your REST API endpoints by specifying latency constraints and reliability metrics within the endpoint deliverable and implementation plan.

Why does my REST API need input validation and sanitization for CRUD operations?

Your REST API needs robust input validation and sanitization for CRUD operations to prevent malformed requests, ensure data integrity, and maintain secure, reliable behavior under real production constraints.