eduardo-sl

go-agent-skills

Curated AI agent skills for Go projects. Install with one command, works everywhere.

npx skills add eduardo-sl/go-agent-skills

Supports Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, OpenCode, and 37+ more agents. Compatible with the open Agent Skills ecosystem and npx skills CLI.

Built on the Uber Go Style Guide, Effective Go, and hard-won production experience with large-scale Go services.

---

Why

AI coding agents are as good as the context you give them. Without Go-specific guidance, they'll write Java-flavored Go, ignore idiomatic error handling, create goroutine leaks, and use interface{} where generics belong.

These skills teach your agent how to write Go the way experienced Go engineers do — with proper error wrapping, consumer-side interfaces, table-driven tests, and all the idioms that make Go code maintainable at scale.

Skills Catalog

Skills load automatically based on context. You can also invoke them directly via slash command (e.g., /go-code-review).

Code Quality

Skill	What it does	Triggers
go-coding-standards	Style conventions, naming, imports, struct init, formatting	"check Go style", "fix formatting"
go-code-review	Structured review process with severity classification	"review this code", "check this PR"
go-error-handling	Error wrapping, sentinels, custom types, errors.Is/As	"handle errors", "error wrapping"
go-context	Context propagation, cancellation, timeouts, values	"context usage", "timeout", "context cancellation"
go-modernize	Generics, slog, errors.Join, slices/maps, range-over-func	"modernize", "use generics", "update Go"

Architecture & Design

Skill	What it does	Triggers
go-architecture-review	Package layout, dependency direction, layering, internal/	"review architecture", "project layout"
go-interface-design	Consumer-side interfaces, composition, compliance checks	"design interface", "accept interfaces"
go-api-design	REST/gRPC handlers, middleware, graceful shutdown, pagination	"design API", "HTTP handler"
go-design-patterns	Functional options, factory, strategy, middleware/decorator	"design pattern", "functional options"

Data

Skill	What it does	Triggers
go-database	Connection pools, transactions, sqlc, migrations, repository pattern	"database access", "SQL query", "transactions"

Safety & Performance

Skill	What it does	Triggers
go-concurrency-review	Goroutine lifecycle, channels, mutexes, race detection	"check thread safety", "goroutine leak"
go-security-audit	OWASP, SQL injection, auth, secrets, input validation	"security review", "check vulnerabilities"
go-performance-review	Allocations, benchmarking, pprof, hot path optimization	"check performance", "reduce allocations"
go-observability	Structured logging (slog), tracing, metrics, OpenTelemetry	"add logging", "tracing", "metrics"

Testing

Skill	What it does	Triggers
go-test-quality	Test philosophy, subtests, httptest, golden files, fuzz, testcontainers	"add tests", "improve coverage"
go-test-table-driven	Deep dive on table-driven tests: when to use, struct design, refactoring	"table-driven test", "test matrix"

Workflow

Skill	What it does	Triggers
go-dependency-audit	Module hygiene, govulncheck, dep evaluation, go.mod review	"check dependencies", "audit deps"
git-commit	Conventional Commits, atomic commits, pre-commit verification	"commit changes", "commit message"

Quick Start

Install via npx (recommended)

# Install all skills (interactive — picks your agents)
npx skills add eduardo-sl/go-agent-skills

# List available skills before installing
npx skills add eduardo-sl/go-agent-skills --list

# Install specific skills
npx skills add eduardo-sl/go-agent-skills --skill go-code-review --skill go-concurrency-review