Agent Skills

golang

A skill module or guideline for AI coding assistants that need to understand and apply Go(Golang) best practices

Instalação
CLI
npx skills add https://github.com/saisudhir14/golang-agent-skill --skill golang

Instale esta skill com a CLI e comece a usar o fluxo de trabalho SKILL.md em seu espaço de trabalho.

Última atualização em 4/22/2026

claude-skills

Go best practices for AI coding agents. Distilled from Google Go Style Guide, Uber Go Style Guide, Effective Go, and Go Code Review Comments. Updated for Go 1.25.

Install: skills.sh/saisudhir14/claude-skills

npx skills add saisudhir14/claude-skills

Skills

This repository provides 9 focused skills that work across 20+ AI coding agents:

Skill Description
golang Complete Go best practices guide (main skill)
go-error-handling Error wrapping, sentinel errors, custom types, error flow
go-concurrency Goroutines, channels, errgroup, mutexes, atomics
go-testing Table-driven tests, benchmarks, synctest, go-cmp
go-performance Memory allocation, string ops, GOMAXPROCS, weak pointers
go-code-review Quick-reference checklist for Go code reviews
go-linting golangci-lint config, CI integration, linter guidance
go-project-layout Directory structure, Makefile, Dockerfile, module setup
go-security SQL injection, path traversal, secrets, crypto, HTTP hardening

Supported Agents

Works with all SKILL.md-compatible agents:

Agent Status
Claude Code Supported
Cursor Supported
GitHub Copilot Supported
Codex CLI Supported
Gemini CLI Supported
OpenCode Supported
Amp Supported
Windsurf Supported
Zed Supported
Goose Supported
Roo Code Supported
Kiro Supported
Cline Supported
Antigravity Supported
Trae Supported
Continue Supported
Aider Supported
Sourcegraph Cody Supported

Topics Covered

  • Error Handling: wrapping, sentinel errors, custom types, error joining (Go 1.20+)
  • Concurrency: goroutine lifecycle, errgroup, mutexes, typed atomics (Go 1.19+), sync.Map (Go 1.24+)
  • Naming: MixedCaps, initialisms, receivers, packages
  • Generics: type constraints, generic aliases (Go 1.24+)
  • Iterators: range-over-func (Go 1.23+), string/bytes iterators (Go 1.24+)
  • Testing: table-driven, T.Context/T.Chdir (Go 1.24+), b.Loop (Go 1.24+), synctest (Go 1.25+)
  • Performance: strconv, preallocating, strings.Builder, struct alignment
  • Resource Management: runtime.AddCleanup, weak pointers, os.Root (Go 1.24+)
  • Patterns: functional options, graceful shutdown, dependency injection
  • Runtime: container-aware GOMAXPROCS (Go 1.25+), encoding/json/v2 (Go 1.25 experimental)
  • Linting: golangci-lint setup, recommended linters, CI integration, suppression patterns
  • Project Layout: cmd/, internal/, Makefile, Dockerfile, module setup
  • Security: SQL injection, path traversal, secrets management, crypto, HTTP hardening, govulncheck

Repository Structure

.
├── SKILL.md                          # Main skill (comprehensive guide)
├── skills/
│   ├── go-error-handling/SKILL.md    # Error handling deep dive
│   ├── go-concurrency/SKILL.md       # Concurrency patterns
│   ├── go-testing/SKILL.md           # Testing and benchmarks
│   ├── go-performance/SKILL.md       # Performance optimization
│   ├── go-code-review/SKILL.md       # Code review checklist
│   ├── go-linting/SKILL.md          # golangci-lint configuration
│   ├── go-project-layout/SKILL.md   # Project structure and setup
│   └── go-security/SKILL.md         # Secure coding patterns
├── references/
│   ├── error-handling.md             # Extended error handling examples
│   ├── concurrency.md                # Extended concurrency patterns
│   ├── testing.md                    # Extended testing patterns
│   ├── performance.md                # Extended performance patterns
│   ├── patterns.md                   # Extended Go patterns
│   └── gotchas.md                    # Common pitfalls reference
├── LICENSE
└── README.md

Sources

License

MIT