api-designer
Enforces REST conventions and standardized response formats for consistent API design.
Install
mkdir -p .claude/skills/api-designer-ewsofficial && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/15773" && unzip -o skill.zip -d .claude/skills/api-designer-ewsofficial && rm skill.zipInstalls to .claude/skills/api-designer-ewsofficial
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.
Design RESTful APIs with consistent patterns and best practices.Key capabilities
- →Define API endpoint methods like GET, POST, PUT, PATCH, and DELETE
- →Structure successful API responses with data and metadata
- →Format error responses with specific codes and messages
- →Map HTTP status codes to their meanings
- →Generate a JavaScript endpoint template with error handling
How it works
The skill provides templates for REST conventions, response formats, status codes, and an endpoint template to guide API design.
Inputs & outputs
When to use api-designer
- →Designing REST API endpoints
- →Standardizing error responses
- →Defining API request/response formats
About this skill
API Designer Skill
This skill helps design clean, consistent REST APIs.
REST Conventions
| Method | Purpose | Example |
|---|---|---|
| GET | Read | GET /api/users |
| POST | Create | POST /api/users |
| PUT | Update (full) | PUT /api/users/1 |
| PATCH | Update (partial) | PATCH /api/users/1 |
| DELETE | Remove | DELETE /api/users/1 |
Response Format
Success
{
"success": true,
"data": { ... },
"meta": { "timestamp": "..." }
}
Error
{
"success": false,
"error": {
"code": "INVALID_INPUT",
"message": "Description"
}
}
Status Codes
| Code | Meaning |
|---|---|
| 200 | OK |
| 201 | Created |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 500 | Server Error |
Endpoint Template
router.get('/resource', async (req, res) => {
try {
const data = await getData();
res.json({ success: true, data });
} catch (err) {
res.status(500).json({
success: false,
error: { message: err.message }
});
}
});
How it compares
This skill offers predefined structures and templates for REST API design, unlike manually creating each component from scratch.
Compared to similar skills
api-designer side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| api-designer (this skill) | 0 | 6mo | No flags | Beginner |
| fastapi-templates | 520 | 2mo | No flags | Intermediate |
| android-kotlin-development | 268 | 5mo | Review | Advanced |
| fastapi-pro | 79 | 4mo | No flags | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
fastapi-templates
wshobson
Create production-ready FastAPI projects with async patterns, dependency injection, and comprehensive error handling. Use when building new FastAPI applications or setting up backend API projects.
android-kotlin-development
aj-geddes
Develop native Android apps with Kotlin. Covers MVVM with Jetpack, Compose for modern UI, Retrofit for API calls, Room for local storage, and navigation architecture.
fastapi-pro
sickn33
Build high-performance async APIs with FastAPI, SQLAlchemy 2.0, and Pydantic V2. Master microservices, WebSockets, and modern Python async patterns. Use PROACTIVELY for FastAPI development, async optimization, or API architecture.
telegram-bot-builder
davila7
Expert in building Telegram bots that solve real problems - from simple automation to complex AI-powered bots. Covers bot architecture, the Telegram Bot API, user experience, monetization strategies, and scaling bots to thousands of users. Use when: telegram bot, bot api, telegram automation, chat bot telegram, tg bot.
telegram-mini-app
davila7
Expert in building Telegram Mini Apps (TWA) - web apps that run inside Telegram with native-like experience. Covers the TON ecosystem, Telegram Web App API, payments, user authentication, and building viral mini apps that monetize. Use when: telegram mini app, TWA, telegram web app, TON app, mini app.
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.