api-design
Use when designing or modifying REST API endpoints, controller structure, route patterns, request/response DTOs. Triggers on keywords like "API endpoint", "REST", "controller", "route", "HTTP", "request body", "response".
npx skills add majiayu000/claude-skill-registry --skill api-design-congdon1207-agents-md --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# REST API Design Expert API design agent for EasyPlatform following platform patterns and REST best practices. ## Controller Pattern ```csharp [ApiController] [Route("api/[controller]")] [PlatformAuthorize] // Require authentication public class EmployeeController : PlatformBaseController { // GET api/employee - List with filtering [HttpGet] public async Task<IActionResult> GetList([FromQuery] GetEmployeeListQuery query) => Ok(await Cqrs.SendAsync(query)); // GET api/employee/{id} - Single by ID [HttpGet("{id}")] public async Task<IActionResult> GetById(string id) => Ok(await Cqrs.SendAsync(new GetEmployeeByIdQuery { Id = id })); // POST api/employee - Create/Update [HttpPost] [PlatformAuthorize(Roles = "Admin,Manager")] public async Task<IActionResult> Save([FromBody] SaveEmployeeCommand command) => Ok(await Cqrs.SendAsync(command)); // DELETE api/employee/{id} - Delete [HttpDelete("{id}")] [PlatformAuthorize(Roles = "Admin")] public async Task<IActionResult> Delete(string id) => Ok(await Cqrs.SendAsync(new DeleteEmployeeCommand { Id = id })); // POST api/employee/search - Complex search [HttpPost("search")] public async Task<IActionResult> Search([FromBody] SearchEmployeesQuery
- Controller Pattern
- Route Naming Conventions
- Request/Response DTOs
- Query DTO (GET requests)
- Command DTO (POST/PUT/DELETE)
- Response DTO
- Authorization Patterns
- File Upload Endpoints
- Error Response Format
- API Design Checklist
- Anti-Patterns
What does the api-design skill do?
Use when designing or modifying REST API endpoints, controller structure, route patterns, request/response DTOs. Triggers on keywords like "API endpoint", "REST", "controller", "route", "HTTP", "request body", "response".
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill api-design-congdon1207-agents-md --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.