Menu
Structures REST API routes with Huma v2 and Echo. Use when creating or modifying API endpoints, route handlers, or OpenAPI-backed HTTP APIs in this project.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Naming rules for this Go API repo. Use when creating or renaming packages, files, handlers, types, variables, tests, and helper functions so names stay domain-first and consistent with existing patterns.
Uses Ent ORM for schema, queries, hooks, and migrations with PostgreSQL. Use when defining schemas, writing database queries, or running migrations in this project.
Writes clear, concise git commit messages. Use when committing changes or when the user asks for commit message help.
Writes idiomatic Go with composition, explicit errors, and focused functions. Use when writing or reviewing Go code in this project.
Build CRUD REST APIs with Huma v2 and Ent—list, get one, update, delete—for global resources and for resources owned by the authenticated user (input.User). Use when adding or refactoring list/get/update/delete endpoints in Huma + Ent projects.
| name | huma-api |
| description | Structures REST API routes with Huma v2 and Echo. Use when creating or modifying API endpoints, route handlers, or OpenAPI-backed HTTP APIs in this project. |
Huma v2 with Echo adapter. Use Input/Output types, Resolve for validation, and huma.Error* for errors.
huma.Register(api, huma.Operation{
OperationID: "SignInAPI",
Method: http.MethodPost,
Path: "/auth/signin",
Tags: []string{"auth"},
}, SignInAPI)
return nil, huma.Error404NotFound("User not found.")
return nil, huma.Error400BadRequest("Your password is incorrect.")
return nil, huma.Error500InternalServerError("Unable to authenticate.")
For full route patterns and examples, see AGENTS.md in the repo root.