api-developer
Standardizes REST API development through consistent resource modeling, documentation, and error handling.
Install
mkdir -p .claude/skills/api-developer && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/16342" && unzip -o skill.zip -d .claude/skills/api-developer && rm skill.zipInstalls to .claude/skills/api-developer
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
API developer specializing in clean, well-documented REST APIsKey capabilities
- →Define resource models and relationships for APIs
- →Design URL structures following REST conventions
- →Implement request and response validation
- →Add complete error handling to APIs
- →Generate OpenAPI documentation for APIs
- →Write integration tests for API endpoints
How it works
The skill designs REST APIs by defining resource models, URL structures, and implementing validation and error handling, then generates OpenAPI documentation and integration tests.
Inputs & outputs
When to use api-developer
- →Designing RESTful product catalog APIs
- →Creating user management API endpoints
- →Building webhook integration schemas
About this skill
API Developer
Specialize in clean, well-documented REST APIs with consistent contracts.
Core Responsibilities
- Define resource model and relationships
- Design URL structure following REST conventions
- Implement request/response validation
- Add error handling for validation failures, auth errors, not-found, and server faults
- Generate OpenAPI documentation
- Write integration tests
API Design Principles
- Resource-Oriented: Nouns for resources, verbs via HTTP methods
- Consistent: Uniform naming, response formats, error handling
- Discoverable: HATEOAS links, clear documentation
- Versioned: Backward compatibility, deprecation strategy
Examples
- "Create user management API"
- "Design webhook integration endpoints"
- "Build RESTful product catalog API"
Guidelines
REST Standards
- GET: Retrieve resources (idempotent)
- POST: Create new resources
- PUT: Full update (idempotent)
- PATCH: Partial update
- DELETE: Remove resources (idempotent)
Response Structure
{
"data": {},
"meta": {"pagination": {}},
"links": {"self": "", "next": ""},
"errors": []
}
Error Handling
- 400: Bad Request (validation errors)
- 401: Unauthorized (auth required)
- 403: Forbidden (insufficient permissions)
- 404: Not Found
- 422: Unprocessable Entity
- 500: Internal Server Error
Quality Requirements
- Include OpenAPI spec in PR
- Validate all inputs
- Rate limiting configured
- Authentication required
- Pagination for collections
Output Instructions
For report generation, see: @.claude/skills/api-developer/template.md
Intelligence Queries
For accessing proven patterns and solutions, see: @.claude/skills/api-developer/scripts/intelligence.sh
Skill Activation Announcement
MANDATORY — first line of every response after skill load:
🔧 Skill actief: api-developer
No exceptions. This must appear before any other content.
How it compares
This skill provides a structured approach to API development, ensuring consistency and adherence to REST principles, unlike ad-hoc API creation.
Compared to similar skills
api-developer side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| api-developer (this skill) | 0 | 2mo | Review | Intermediate |
| mcp-builder | 136 | 3mo | Review | Advanced |
| stripe-integration | 48 | 2mo | No flags | Advanced |
| copilot-sdk | 7 | 4mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by Vinix24
View all by Vinix24 →You might also like
mcp-builder
anthropics
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
stripe-integration
wshobson
Implement Stripe payment processing for robust, PCI-compliant payment flows including checkout, subscriptions, and webhooks. Use when integrating Stripe payments, building subscription systems, or implementing secure checkout flows.
copilot-sdk
github
Build agentic applications with GitHub Copilot SDK. Use when embedding AI agents in apps, creating custom tools, implementing streaming responses, managing sessions, connecting to MCP servers, or creating custom agents. Triggers on Copilot SDK, GitHub SDK, agentic app, embed Copilot, programmable agent, MCP server, custom agent.
mistral-upgrade-migration
jeremylongshore
Analyze, plan, and execute Mistral AI SDK upgrades with breaking change detection. Use when upgrading Mistral SDK versions, detecting deprecations, or migrating to new API versions. Trigger with phrases like "upgrade mistral", "mistral migration", "mistral breaking changes", "update mistral SDK", "analyze mistral version".
documenso-install-auth
jeremylongshore
Install and configure Documenso SDK/API authentication. Use when setting up a new Documenso integration, configuring API keys, or initializing Documenso in your project. Trigger with phrases like "install documenso", "setup documenso", "documenso auth", "configure documenso API key".
gamma-upgrade-migration
jeremylongshore
Upgrade Gamma SDK versions and migrate between API versions. Use when upgrading SDK packages, handling deprecations, or migrating to new API versions. Trigger with phrases like "gamma upgrade", "gamma migration", "gamma new version", "gamma deprecated", "gamma SDK update".