skills.rest
Adelie-Squad
Adelie-SquadOFFICIAL
Explore all skills by this author →
GitHub

API Developer Agent

Design OpenAPI-compliant RESTful API contracts with schemas, authentication, and versioning.

17|1|Updated Feb 3, 2026
Search Tags:#openapi#swagger#error-handling#api-design#endpoint-definition#schema-definition
One-click install
npx skills add https://github.com/Adelie-Squad/solopreneur-team-agents --skill api-developer-agent
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: API Developer Agent
Source: https://github.com/Adelie-Squad/solopreneur-team-agents/tree/main/agents/engineering/api-developer
Command: npx skills add https://github.com/Adelie-Squad/solopreneur-team-agents --skill api-developer-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Solo founders and engineering leads struggle to capture consistent API contracts, leading to stagnant handoffs, unclear expectations, and client-server confusion.

Core Features & Use Cases

  • API design principles covering RESTful URL conventions, HTTP method choices, and status code guidelines to keep every interaction predictable.
  • Endpoint planning for auth, user, and post resources with authentication rules and operation summaries tailored to new features.
  • Schema and error standards that define OpenAPI components, paginated responses, and structured error payloads for documentation and validation.
  • Use Case: Feed a feature spec plus data model to generate the endpoint tables, request/response schemas, and Swagger-ready documentation for the backend team.

Quick Start

Ask the API Developer Agent to translate the feature spec and data model into RESTful endpoints, schemas, and documentation.

Frequently Asked Questions about API Developer Agent

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

FAQPage Schema
How do I generate OpenAPI schemas from a feature spec for backend handoff?▼

Generate OpenAPI schemas by feeding a feature spec and data model to the API Developer Agent, which translates them into RESTful endpoints, request/response schemas, and Swagger-ready documentation for backend handoff.

What's the best way to standardize RESTful API error responses and pagination?▼

Standardize RESTful API error responses and pagination by defining OpenAPI components, structured error payloads, and paginated response schemas that ensure consistent documentation and validation across client-server interactions.

Can I use this to plan endpoint definitions for auth and user resources?▼

Yes, you can use it to plan endpoint definitions for auth, user, and post resources, applying RESTful URL conventions, HTTP method choices, and authentication rules tailored to new product features.

Why do I need an API contract for client-server communication?▼

You need an API contract for client-server communication to prevent stagnant handoffs, unclear expectations, and client-server confusion by ensuring consistent API design, authentication handling, and versioning standards.

Does this API design agent handle status code guidelines and versioning?▼

Yes, the API design agent handles status code guidelines and versioning, applying RESTful URL conventions, authentication handling, and operation summaries to keep every client-server interaction predictable.

Related Skills

Explore More Software Engineering Skills→
RangeyRoverRangeyRover
3

speckit.plan

Generate research documents, data models, and API contracts from feature specifications.

Community
Advanced
apassuelloapassuello

automating-api-testing

Generate and execute API tests for REST and GraphQL endpoints.

Community
Intermediate
HouseGarofaloHouseGarofalo
3

openapi-swagger

Design, document, and generate APIs from OpenAPI and Swagger specifications.

Official
Advanced
CybLowCybLow
1

api-graphql

Define typed GraphQL schemas with Strawberry for Python backends.

Community
Advanced