go-best-practices
Write idiomatic Go on the hexagonal, vertical-slice stack. Use this skill whenever you write, refactor, debug, or explain Go code: new packages, files, functions, structs, interfaces, error types, goroutines, channels, context, generics, go.mod, or table-driven tests. Trigger on any mention of Go, golang, .go files, gofmt, go vet, golangci-lint, pgx, pgxpool, sqlc, golang-migrate, goose, river, chi, wire, redis, validator, slog, net/http, ServeMux, context, goroutines, or channels, even when the user does not say "best practices" or "idiomatic" code. Synthesized from Effective Go, the Go Code Review Comments wiki, the Google Go Style Guide, Rob Pike's Go Concurrency Patterns, and the backend-go handbook. For auditing existing code use go-review; for translating C, Python, or JavaScript into Go use go-port.
Pinned to revision 37fdf40bf942, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/go-best-practices/SKILL.md
- skills/go-best-practices/evals/ratelimit-library/case.yaml
- skills/go-best-practices/evals/ratelimit-library/graders/01-stdlib-only.md
- skills/go-best-practices/evals/ratelimit-library/graders/02-sentinel-and-wrap.md
- skills/go-best-practices/evals/ratelimit-library/graders/03-no-one-impl-interface.md
- skills/go-best-practices/evals/ratelimit-library/graders/04-context-first-param.md
- skills/go-best-practices/evals/ratelimit-library/graders/05-table-driven-tests.md
- skills/go-best-practices/evals/ratelimit-library/graders/06-usable-zero-value.md
- skills/go-best-practices/evals/ratelimit-library/graders/07-vet-golangci-clean.md
- skills/go-best-practices/evals/ratelimit-library/graders/08-slog-not-prints.md
- skills/go-best-practices/evals/ratelimit-library/prompt.md
- skills/go-best-practices/evals/refactor-member-module/case.yaml
- skills/go-best-practices/evals/refactor-member-module/files/member.go
- skills/go-best-practices/evals/refactor-member-module/graders/01-builds-and-tests-pass.md
- skills/go-best-practices/evals/refactor-member-module/graders/02-errors-wrapped-with-w.md
- skills/go-best-practices/evals/refactor-member-module/graders/03-no-bool-params.md
- skills/go-best-practices/evals/refactor-member-module/graders/04-no-panic-on-bad-input.md
- skills/go-best-practices/evals/refactor-member-module/graders/05-table-tests-added.md
- skills/go-best-practices/evals/refactor-member-module/graders/06-no-one-impl-interface.md
- skills/go-best-practices/evals/refactor-member-module/graders/07-goroutine-has-owner.md
- skills/go-best-practices/evals/refactor-member-module/graders/08-clipping-noted.md
- skills/go-best-practices/evals/refactor-member-module/place-files.sh
- skills/go-best-practices/evals/refactor-member-module/prompt.md
- skills/go-best-practices/evals/slice-regen/case.yaml
- skills/go-best-practices/evals/slice-regen/files/internal/features/widgets/domain.go
- skills/go-best-practices/evals/slice-regen/files/internal/features/widgets/http.go
- skills/go-best-practices/evals/slice-regen/files/internal/features/widgets/module.go
- skills/go-best-practices/evals/slice-regen/files/internal/features/widgets/ports.go
- skills/go-best-practices/evals/slice-regen/files/internal/features/widgets/postgres.go
- skills/go-best-practices/evals/slice-regen/files/internal/features/widgets/queries.sql
- skills/go-best-practices/evals/slice-regen/files/internal/features/widgets/usecase.go
- skills/go-best-practices/evals/slice-regen/files/migrations/0001_init.sql
- skills/go-best-practices/evals/slice-regen/graders/01-builds-and-lints-clean.md
- skills/go-best-practices/evals/slice-regen/graders/02-domain-stays-pure.md
- skills/go-best-practices/evals/slice-regen/graders/03-port-not-import.md
- skills/go-best-practices/evals/slice-regen/graders/04-query-in-queries-sql.md
- skills/go-best-practices/evals/slice-regen/graders/05-migration-ships-down.md
- skills/go-best-practices/evals/slice-regen/graders/06-existing-code-not-rewritten.md
- skills/go-best-practices/evals/slice-regen/graders/07-envelope-code-not-new.md
- skills/go-best-practices/evals/slice-regen/place-files.sh
- skills/go-best-practices/evals/slice-regen/prompt.md
- skills/go-best-practices/references/backend-go-stack.md
- skills/go-best-practices/references/effective-go.md
- skills/go-best-practices/references/go-code-review-comments.md
- skills/go-best-practices/references/go-concurrency-patterns.md
- skills/go-best-practices/references/google-go-style-guide.md
Every link opens the file at its source, pinned to the revision this page describes.