gopilot

A Claude Code plugin with production-tested Go patterns covering idiomatic code style, error handling, testing, concurrency, security, generics, iterators, and stdlib patterns up to Go 1.26.

Quick Start

# 1. Add the plugin marketplace
/plugin marketplace add git@github.com:gonzaloserrano/gopilot.git

# 2. Install the plugin
/plugin install gopilot

# 3. Enable auto-update (recommended)
# /plugin → Marketplaces tab → gopilot → Enable auto-update

# 4. Use the skill
# Tell Claude: "use the gopilot skill and implement XYZ"
# Or once skill invocation is fixed: /gopilot

Skill Coverage

| Topic | Patterns | |-------|----------| | Design | Simplicity, pure functions, zero values, guard clauses, small interfaces | | Code Style | gofmt, golangci-lint, naming conventions, package design | | Error Handling | Wrapping, sentinel errors, errors.Is/As, errors.Join | | Generics | Type parameters, constraints, comparable, cmp.Ordered | | Testing | Table-driven tests, testify, t.Parallel(), t.Cleanup(), benchmarks | | Concurrency | Channels, channel axioms, mutexes, errgroup, sync.Once, WaitGroup.Go, context cancellation | | Iterators | iter.Seq, slices.Collect, maps.Keys, range over func, custom iterators | | Interfaces | Consumer-side definition, compile-time checks, function types | | AIP | Resource-oriented gRPC APIs with einride/aip-go: pagination, filtering, ordering, field masks, resource names | | Patterns | Options pattern, cmp.Or, HTTP best practices, slog | | Security | Input validation, SQL injection, auth, sessions, TLS, CSRF, crypto | | Linting | golangci-lint configuration, recommended linters, auto-fix | | TDD Baby Steps | Red-green-refactor, table-driven test progression, t.Run, t.Helper |

Go Version Support

Covers features up to Go 1.26, including:

Go 1.26: errors.AsType[T](), new(expr), t.ArtifactDir(), go fix, goroutine leak profile
Go 1.25: testing/synctest, wg.Go(), http.CrossOriginProtection
Go 1.24: t.Context(), t.Chdir(), os.OpenRoot(), runtime.AddCleanup, generic type aliases, b.Loop()
Go 1.23: Iterators (iter.Seq), slices.Collect, maps.Keys
Go 1.22: cmp.Or, range over int, loop variable fix
Go 1.21: clear(), slices/maps packages

Plugin Management

# Update to latest version
/plugin update gopilot

# Check current version
/plugin list

# Uninstall
/plugin uninstall gopilot

# Test locally during development
claude --plugin-dir ./

Local Development

git clone git@github.com:gonzaloserrano/gopilot.git
cd gopilot
claude --plugin-dir .

# Test the skill
# Tell Claude: "use the gopilot skill"

Contributing

Contributions welcome! The skill is defined in skills/gopilot/SKILL.md with detailed security topics in skills/gopilot/reference/.

Adding Patterns

Fork and clone the repository
Edit skills/gopilot/SKILL.md
Test locally with claude --plugin-dir .
Submit a PR

Guidelines

Keep patterns concise and actionable
Include code examples where helpful
Reference Go version for version-specific features
Prefer stdlib over external dependencies

References

Claude Code Skills Documentation
Skill Authoring Best Practices
Effective Go
Go Code Review Comments
Go Proverbs
Google API Improvement Proposals
einride/aip-go
OWASP Go Secure Coding Practices
Don't just check errors, handle them gracefully - Opaque errors, behavior assertion, handle once

Gopilot

Install / Use

README