User asks to add a new API endpoint or CRUD route.
Existing API contract needs extension.
Backend changes require request validation and response contract updates.
Workflow
Read project specs first: specs/specs.md, then role-specific specs as needed.
Detect backend conventions from the repo (routing, controller/service patterns, validation style).
Define endpoint contract before implementation:
Path + method
Auth requirements
Request validation
Response shape and error shape
Implement with thin transport layer and business logic in domain/service/action classes.
Add focused tests for success path, validation failure, and authorization failure.
Quality Bar
Keep endpoint behavior idempotent where required.
Avoid N+1 queries and over-fetching.
Return consistent JSON payloads.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: erinrugas-artisan-agents-api-endpoint3description: API Endpoint Skill4---56# API Endpoint Skill78## When to Apply9- User asks to add a new API endpoint or CRUD route.10- Existing API contract needs extension.11- Backend changes require request validation and response contract updates.1213## Workflow141. Read project specs first: `specs/specs.md`, then role-specific specs as needed.152. Detect backend conventions from the repo (routing, controller/service patterns, validation style).163. Define endpoint contract before implementation:17 - Path + method18 - Auth requirements19 - Request validation20 - Response shape and error shape214. Implement with thin transport layer and business logic in domain/service/action classes.225. Add focused tests for success path, validation failure, and authorization failure.2324## Quality Bar25- Keep endpoint behavior idempotent where required.26- Avoid N+1 queries and over-fetching.27- Return consistent JSON payloads.2829---30> Converted and distributed by [TomeVault](https://tomevault.io/claim/erinrugas) — claim your Tome and manage your conversions.31<!-- tomevault:4.0:skill_md:2026-04-13 -->
Run npx skillmds@latest add tomevault-io/erinrugas-artisan-agents-api-endpoint in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
API Endpoint Skill It is listed under Integrations & APIs on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.
tomevault-io