Claude-skill-registry controller-generation

Code generation for CRUD endpoints

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/controller-generation" ~/.claude/skills/majiayu000-claude-skill-registry-controller-generation && rm -rf "$T"

manifest: skills/data/controller-generation/SKILL.md

Controller Code Generation

The system uses

core_generate

to automatically create standard CRUD operations for controllers.

Code Generation Command

Add this directive to your

setup.go

file:

//go:generate core_gen controller Account -modelPackage=account

Parameters:

```
controller
```
- Command type
```
Account
```
- Model name (PascalCase)
```
-modelPackage=account
```
- Package name containing the model
```
-options=admin
```
if its an admin only controller
```
-skip=xxxYYY,aaaBBB
```
skip generating this function because we need to customize it

Generated Files

Running

go generate

creates two files:

x_gen_admin.go

- Admin CRUD handlers:

```
adminIndex
```
- List all resources
```
adminGet
```
- Get single resource
```
adminCreate
```
- Create new resource
```
adminUpdate
```
- Update existing resource
```
adminCount
```
- Get total count

(optionally)

x_gen_auth.go

- Public CRUD handlers:

```
authIndex
```
- List resources (filtered to user's data)
```
authGet
```
- Get single resource (with ownership check)
```
authCreate
```
- Create new resource
```
authUpdate
```
- Update resource (with ownership check)

Generated Endpoints

Method	Admin Route	Public Route	Function	Description
GET	`/admin/account`	`/account`	`adminIndex` , `authIndex`	List resources
GET	`/admin/account/{id}`	`/account/{id}`	`adminGet` , `authGet`	Get single resource
POST	`/admin/account`	`/account`	`adminCreate` , `authCreate`	Create new resource
PUT	`/admin/account/{id}`	`/account/{id}`	`adminUpdate` , `authUpdate`	Update resource
GET	`/admin/account/count`	-	`adminCount`	Get total count
GET	`/admin/account/_ts`	-	TypeScript	TS type generation

Skipping Endpoints

You can disable specific endpoints using the

-skip

parameter:

//go:generate core_gen controller AiTool -modelPackage=ai_tool -skip=authCreate,authUpdate

This will generate all endpoints except

authCreate

and

authUpdate

Available Skip Options:

```
adminIndex
```
- Skip admin list endpoint
```
adminGet
```
- Skip admin get endpoint
```
adminCreate
```
- Skip admin create endpoint
```
adminUpdate
```
- Skip admin update endpoint
```
adminCount
```
- Skip admin count endpoint
```
authIndex
```
- Skip public list endpoint
```
authGet
```
- Skip public get endpoint
```
authCreate
```
- Skip public create endpoint
```
authUpdate
```
- Skip public update endpoint

Common Skip Patterns

Read-only public endpoint:

//go:generate core_gen controller Config -modelPackage=config -skip=authCreate,authUpdate

Admin-only resource:

//go:generate core_gen controller SystemLog -modelPackage=system_log -options=admin

Customizing Generated Code

DO NOT edit generated files directly. They will be overwritten on next generation.

Instead, create custom handlers in separate files, name them accordingly auth.go open.go admin.go

if theres lots of functions, group them together by relation then use a prefix, auth_password.go auth_emails.go

custom_handlers.go:

package account

func customSearch(_ http.ResponseWriter, req *http.Request) ([]*account.Account, int, error) {
    // Custom search logic here
    // ...
}

Then wire up in

setup.go

r.Get("/search", helpers.RoleHandler(helpers.RoleHandlerMap{
    constants.ROLE_ANY_AUTHORIZED: helpers.StandardPublicRequestWrapper(customSearch),
}))

Regenerating Code

Re-run generation after:

Updating skip parameters

go generate path/to/file

Related Skills

controller-handlers - Writing custom handlers
controller-roles - Role-based access control