AP
api-designer
Design RESTful APIs with consistent patterns and best practices.
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.64 charsno explicit “when” trigger
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 }
});
}
});