Skip to content
TrustedSkillsbeta
Back to all skills

Api Design

Listed
eddiebe147·vlatest·backend

Helps with API, design as part of developing backend services and APIs workflows.

Repository

Install on your platform

This skill no longer installs under the name api-design. eddiebe147/claude-settings is deleted or private, so it cannot be installed from.

We check each listing against its upstream repository with the rules the skills CLI uses, last on 2026-10-24. We don't show a command we know will fail.

Repository install instructions

What we know about this skill

Publisher

eddiebe147

Taken from the source listing. We haven't verified who controls this account.

Install target

Live repository

Not pinned. Installing fetches whatever the repository holds at the time you run the command.

Nobody has reviewed this code. TrustedSkills indexes and links skills; it does not audit, run or scan them. A skill runs with whatever access you give your agent — read the source before you install it.

Automated safety checks

scanned

We could not read this skill's source, so none of the checks below were run.

Not scanned. repository not found or private Source recorded as eddiebe147/claude-settings.
This is a static scan, not a review. It reads the skill's files; it does not run them, and it cannot tell you whether the skill is any good or whether the code does what its description says. A skill runs with whatever access you give your agent.
What each check looks for →

About this skill

What it does

This skill assists in designing REST APIs, covering key aspects from URL structure to error handling and versioning. It provides guidance on standard HTTP methods (GET, POST, PUT, PATCH, DELETE), nested resources, and appropriate HTTP status codes for various scenarios. The skill also outlines best practices for request/response design including pagination, single resource responses, and structured error reporting.

When to use it

  • When designing a new backend service or API workflow.
  • To ensure adherence to REST API design principles.
  • For guidance on structuring URLs and handling HTTP status codes correctly.
  • To understand how to format request and response bodies for clarity and consistency.
  • When implementing query parameters for filtering, sorting, pagination, field selection, and searching.

Key capabilities

  • Provides examples of REST API URL structures (e.g., GET /api/v1/resources/{id}).
  • Defines common HTTP status codes and their appropriate usage (200 OK, 404 Not Found, etc.).
  • Illustrates collection and single resource response formats.
  • Explains how to structure error responses with code, message, and details.
  • Covers query parameter patterns for filtering, sorting, pagination, field selection, and searching.
  • Addresses idempotency considerations for POST, PUT, and DELETE requests.
  • Outlines URL path versioning strategies for API evolution.

Example prompts

  • "Show me an example of a REST endpoint to create a new resource."
  • "What HTTP status code should I return when a resource is not found?"
  • "How can I implement pagination in my API response?"
  • “Give me examples of query parameters for filtering resources by status and type.”

Tips & gotchas

  • This skill focuses on REST API design principles; it does not provide coding implementation details.
  • The skill emphasizes input validation at the API boundary as a security consideration.
  • It recommends using parameterized queries to prevent SQL injection vulnerabilities (though it notes JOOQ handles this).