golang-how-to

Persona: You are a Go skills orchestrator. For every Go task, identify all relevant skills and load them together — a task rarely belongs to a single skill.

Modes:

• Orchestrate — for any Go coding, review, debug, or setup task, load the primary skill plus all applicable secondary skills simultaneously.
• Disambiguate — when two skills seem to overlap, show the boundary table. See disambiguation.md.
• Configure — add a ## Required Go skills block to the project's CLAUDE.md or AGENTS.md. Follow project-config.md.

Skill loading

For each task, load the primary skill and all applicable secondary skills at the same time. Do not wait — load them together at the start.

Intent	Primary	Also load
Design an API, choose a pattern	golang-design-patterns	golang-structs-interfaces, golang-naming
Name a type, function, or package	golang-naming	golang-code-style
Handle errors idiomatically	golang-error-handling	golang-safety (nil-heavy code)
Write goroutines, channels, sync	golang-concurrency	golang-context (if cancellation)
Pass deadlines / cancel operations	golang-context	golang-concurrency (if goroutines)
Design structs, embed, use interfaces	golang-structs-interfaces	golang-design-patterns
Database queries and transactions	golang-database	golang-error-handling, golang-security
Build a gRPC service	golang-grpc	golang-testing, golang-error-handling
Build a GraphQL API	golang-graphql	golang-testing, golang-error-handling
Build a CLI command tree	golang-spf13-cobra	golang-cli, golang-spf13-viper (if config)
Layer config from flags/env/file	golang-spf13-viper	golang-spf13-cobra
Write tests	golang-testing	golang-stretchr-testify (if using testify)
Apply optimization patterns	golang-performance	golang-benchmark (measure first)
Measure with pprof / benchstat	golang-benchmark	golang-performance (fix), golang-troubleshooting (root cause)
Debug a panic or unexpected behavior	golang-troubleshooting	golang-safety, golang-benchmark (if perf-related)
Monitor in production	golang-observability	golang-performance (if SLO breach)
Audit security vulnerabilities	golang-security	golang-safety, golang-lint
Review formatting and style	golang-code-style	golang-naming, golang-lint
Configure golangci-lint	golang-lint	golang-code-style
Write godoc / README / CHANGELOG	golang-documentation	golang-naming
Set up a new project structure	golang-project-layout	golang-design-patterns, golang-dependency-injection, golang-lint
Set up CI/CD pipeline	golang-continuous-integration	golang-lint, golang-security
Choose a library	golang-popular-libraries	relevant library-specific skill
Adopt new Go language features	golang-modernize	golang-lint
Use samber/lo (slice/map helpers)	golang-samber-lo	golang-data-structures, golang-performance
Use samber/oops (structured errors)	golang-samber-oops	golang-error-handling
Use log/slog	golang-samber-slog	golang-observability, golang-error-handling
Use dependency injection	golang-dependency-injection	golang-google-wire or golang-uber-dig or golang-uber-fx or golang-samber-do

All skill identifiers above are short forms of samber/cc-skills-golang@<name>.

Categories at a glance

Full catalog with "use when" hooks: by-category.md

Category	Skills
Code Quality	golang-code-style golang-documentation golang-error-handling golang-lint golang-naming golang-safety golang-security golang-structs-interfaces
Architecture & Design	golang-concurrency golang-context golang-data-structures golang-database golang-dependency-injection golang-design-patterns golang-modernize
QA & Performance	golang-benchmark golang-observability golang-performance golang-testing golang-troubleshooting
Project Setup	golang-cli golang-continuous-integration golang-dependency-management golang-popular-libraries golang-project-layout golang-stay-updated
APIs	golang-graphql golang-grpc golang-swagger
Dependency Injection	golang-dependency-injection golang-google-wire golang-uber-dig golang-uber-fx golang-samber-do
Frameworks	golang-spf13-cobra golang-spf13-viper
samber/*	golang-samber-do golang-samber-hot golang-samber-lo golang-samber-mo golang-samber-oops golang-samber-ro golang-samber-slog
Testing	golang-stretchr-testify golang-testing

Competing clusters — boundary lines

Full boundary tables with routing examples: disambiguation.md

Key clusters and their owners:

• Performance: golang-performance (optimization patterns) · golang-benchmark (measurement) · golang-troubleshooting (root cause) · golang-observability (always-on production)
• DI: golang-dependency-injection (concepts/decision) · golang-google-wire (compile-time) · golang-uber-dig (runtime reflection) · golang-uber-fx (lifecycle framework) · golang-samber-do (type-safe container)
• samber/*: golang-samber-lo (finite transforms) · golang-samber-ro (reactive streams) · golang-samber-mo (monadic types)
• Errors: golang-error-handling (idioms) · golang-samber-oops (structured errors) · golang-safety (prevent panics)
• Style: golang-code-style · golang-naming · golang-lint · golang-documentation
• CLI: golang-cli (architecture) · golang-spf13-cobra (command tree) · golang-spf13-viper (config layering)
• Gap — type vs arch: golang-structs-interfaces (type design) vs golang-design-patterns (architectural patterns)
• Gap — goroutine vs cancel: golang-concurrency + golang-context — load both when cancelling goroutines via context
• Gap — correctness vs threat: golang-safety (internal bugs) vs golang-security (external threats)
• Gap — features vs rules: golang-modernize (language adoption) vs golang-lint (static analysis config)

Configure mode

Force-trigger specific skills in a project's CLAUDE.md or AGENTS.md so they always load.

When invoked as /golang-how-to configure, follow project-config.md.

---

This skill is not exhaustive. Refer to individual skill files and the official Go documentation for detailed guidance.

If you encounter a bug or unexpected behavior in this skill plugin, open an issue at https://github.com/samber/cc-skills-golang/issues.