Encore Go Api

This teaches Claude how to write Encore Go API endpoints with the proper annotations and patterns. You'd reach for it when building backend services with Encore's framework and want Claude to scaffold endpoints correctly using `//encore:api` annotations, handle context and request structs, and follow Encore's conventions. The skill comes from Encore's official team, which matters since framework-specific tooling benefits from maintainer knowledge. With 269 installs and solid audit scores, it's being used in production. It's narrow in scope but solves a real problem: getting Claude to generate idiomatic Encore code instead of generic Go handlers that won't work with the framework's magic.

skills.sh installs: 597
GitHub stars: 30
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add encoredev/skills --skill encore-go-api --agent claude-code

Installs into .claude/skills of the current project.

Files

Encore Go API Endpoints

Instructions

When creating API endpoints with Encore Go, follow these patterns:

1. Basic API Endpoint

Use the //encore:api annotation above your function:

package user

import "context"

type GetUserParams struct {
    ID string
}

type User struct {
    ID    string `json:"id"`
    Email string `json:"email"`
    Name  string `json:"name"`
}

//encore:api public method=GET path=/users/:id
func GetUser(ctx context.Context, params *GetUserParams) (*User, error) {
    // Implementation
    return &User{ID: params.ID, Email: "user@example.com", Name: "John"}, nil
}

2. POST with Request Body

type CreateUserParams struct {
    Email string `json:"email"`
    Name  string `json:"name"`
}

//encore:api public method=POST path=/users
func CreateUser(ctx context.Context, params *CreateUserParams) (*User, error) {
    // Implementation
    return &User{ID: "new-id", Email: params.Email, Name: params.Name}, nil
}