add-api-endpoint
Create API layer components for a new entity. Includes usecase interactors (internal/usecase/), proto definitions (schema/proto/), gRPC handlers (internal/infrastructure/grpc/), and DI registration. Use when adding CRUD endpoints or Step 3 of CRUD workflow (after add-domain-entity).
npx skills add majiayu000/claude-skill-registry --skill add-api-endpoint --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.
# Add API Endpoint Create complete API layer: usecase interactors, proto definitions, gRPC handlers, and DI registration. ## Prerequisites - Domain entity created (use **add-domain-entity** skill first) - Repository interface and implementation ready - SQLBoiler models generated (`make migrate.up`) ## Workflow Overview ``` 1. Usecase Input/Output --> internal/usecase/input/, output/ 2. Interactor Interface --> internal/usecase/{actor}_{entity}.go 3. Interactor Impl --> internal/usecase/{actor}_{entity}_impl.go 4. Proto Definition --> schema/proto/rapid/{actor}_api/v1/ 5. Generate Proto --> make generate.buf 6. Handler Marshaller --> handler/{actor}/marshaller/{entity}.go 7. Handler Methods --> handler/{actor}/{entity}.go 8. Update Handler Struct --> handler/{actor}/handler.go 9. Register in DI --> dependency/dependency.go 10. Generate & Test --> make generate.mock && make test ``` ## Step 1: Create Usecase Input/Output Location: `internal/usecase/input/{actor}_{entity}.go` Create input structs for each operation (Create, Get, List, Update, Delete). Each struct needs a `Validate()` method. See: [references/usecase-patterns.md](references/usecase-patterns.md#input-structs) Location:
- Prerequisites
- Workflow Overview
- Step 1: Create Usecase Input/Output
- Step 2: Create Interactor Interface
- Step 3: Implement Interactor
- Step 4: Define Protocol Buffers
- Step 5: Generate Proto Code
- Step 6: Create Handler Marshaller
- Step 7: Create Handler Methods
- Step 8: Update Handler Struct
- Step 9: Register in DI
- Step 10: Generate Mocks & Test
- Checklist
- Common Errors
make generate.buf make generate.mock make test
What does the add-api-endpoint skill do?
Create API layer components for a new entity. Includes usecase interactors (internal/usecase/), proto definitions (schema/proto/), gRPC handlers (internal/infrastructure/grpc/), and DI registration. Use when adding CRUD endpoints or Step 3 of CRUD workflow (after add-domain-entity).
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill add-api-endpoint --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.