diff --git a/.agents/skills/golang-pro/SKILL.md b/.agents/skills/golang-pro/SKILL.md index 5b040ca..90f7703 100644 --- a/.agents/skills/golang-pro/SKILL.md +++ b/.agents/skills/golang-pro/SKILL.md @@ -1,6 +1,6 @@ --- name: golang-pro -description: Implements concurrent Go patterns using goroutines and channels, designs and builds microservices with gRPC or REST, optimizes Go application performance with pprof, and enforces idiomatic Go with generics, interfaces, and robust error handling. Use when building Go applications requiring concurrent programming, microservices architecture, or high-performance systems. Invoke for goroutines, channels, Go generics, gRPC integration, CLI tools, benchmarks, or table-driven testing. +description: "Implements concurrent Go patterns using goroutines and channels, designs and builds microservices with gRPC or REST, optimizes Go application performance with pprof, and enforces idiomatic Go with generics, interfaces, and robust error handling. Use when building Go applications requiring concurrent programming, microservices architecture, or high-performance systems. Invoke for goroutines, channels, Go generics, gRPC integration, CLI tools, benchmarks, or table-driven testing." license: MIT metadata: author: https://github.com/Jeffallan @@ -15,7 +15,7 @@ metadata: # Golang Pro -Senior Go developer with deep expertise in Go 1.21+, concurrent programming, and cloud-native microservices. Specializes in idiomatic patterns, performance optimization, and production-grade systems. +Write idiomatic Go 1.21+ code with a focus on concurrency safety, interface-driven design, and production-grade performance. ## Core Workflow @@ -90,35 +90,7 @@ Key properties demonstrated: bounded goroutine lifetime via `ctx`, error propaga ## Constraints -### MUST DO -- Use gofmt and golangci-lint on all code -- Add context.Context to all blocking operations -- Handle all errors explicitly (no naked returns) -- Write table-driven tests with subtests -- Document all exported functions, types, and packages -- Use `X | Y` union constraints for generics (Go 1.18+) -- Propagate errors with fmt.Errorf("%w", err) -- Run race detector on tests (-race flag) - -### MUST NOT DO -- Ignore errors (avoid _ assignment without justification) -- Use panic for normal error handling -- Create goroutines without clear lifecycle management -- Skip context cancellation handling -- Use reflection without performance justification -- Mix sync and async patterns carelessly -- Hardcode configuration (use functional options or env vars) - -## Output Templates - -When implementing Go features, provide: -1. Interface definitions (contracts first) -2. Implementation files with proper package structure -3. Test file with table-driven tests -4. Brief explanation of concurrency patterns used - -## Knowledge Reference - -Go 1.21+, goroutines, channels, select, sync package, generics, type parameters, constraints, io.Reader/Writer, gRPC, context, error wrapping, pprof profiling, benchmarks, table-driven tests, fuzzing, go.mod, internal packages, functional options +- **Always**: `context.Context` on blocking ops, explicit error handling with `%w`, table-driven tests with `-race`, `gofmt` + `golangci-lint` +- **Never**: swallowed errors (`_`), `panic` for control flow, goroutines without lifecycle management, hardcoded config [Documentation](https://jeffallan.github.io/claude-skills/skills/language/golang-pro/)