Implements typed Huma handlers for CRUD resources on the Vikunja /api/v2 REST API.
npx skills add https://github.com/go-vikunja/vikunja --skill api-v2-routes
Please help me install this Agent Skill. Skill: api-v2-routes Source: https://github.com/go-vikunja/vikunja/tree/main/.agents/skills/api-v2-routes Command: npx skills add https://github.com/go-vikunja/vikunja --skill api-v2-routes
Adding or porting resources to Vikunja's Huma-backed /api/v2 API involves many non-obvious conventions—typed per-operation handlers, shared envelopes, error bridging, doc tags, and AutoPatch behavior—that are easy to get wrong and produce silent bugs like empty lists or undocumented endpoints.
handler.Do* functions, and translate domain errors into RFC 9457 problem+json responses.doc: and readOnly:"true" struct tags so the runtime-generated OpenAPI spec is complete, since Huma cannot read Go doc comments.pkg/routes/api/v2/labels.go to register list/read/create/update/delete operations with correct envelopes, ETag handling, and mandatory webtests.Add a new /api/v2 resource for my model by following the api-v2-routes skill, mirroring pkg/routes/api/v2/labels.go.
High-intent search queries and answers about installing and using this skill.
Create a file in pkg/routes/api/v2 defining a Register<Resource>Routes function with one typed Huma handler per operation, then self-register it via an init() calling AddRouteRegistrar. Mirror pkg/routes/api/v2/labels.go as the reference implementation.
v2 uses typed per-operation Huma handlers instead of v1's generic WebHandler, and inverts verb conventions: create is POST and update is PUT in v2 versus PUT and POST in v1. PATCH is synthesized automatically by AutoPatch for every GET+PUT pair.
The DoReadAll result is typed as any, so a blind cast or generic wrapper silently serializes an empty list. Type-assert the result to the concrete slice with an ok check and return a hard error on mismatch.
No for standard CRUD—permissions are enforced by the model's Can* methods through the handler.Do* functions. Only custom non-CRUD routes must check permissions explicitly, since no generic Do* helper exists for them.
Huma generates the schema from struct tags at runtime and cannot read Go doc comments. Every exposed field needs a doc tag, and server-controlled fields like id and created need readOnly:"true" to appear correctly in the spec.
mage test:filter injects -short, which causes the pkg/webtests suite to skip entirely and silently report success. Run the test directly with go test -run '<Name>' ./pkg/webtests/ to actually exercise it.
go-vikunjaImplement CRUDable model operations with Can* permission checks in pkg/models/.
FixPortalConvert ASP.NET controllers to minimal API endpoints with OpenAPI and Scalar support.
jfrogManage JFrog Access tokens, users, groups, and permissions via REST endpoints.
333-333-333Generate OpenAPI specifications from Go swaggo annotations.