# Go Review

> Go review checklist — what to check in Go code, by severity. A reference for writing and reviewing it; in a workflow run the review step records each problem as a finding and the engine decides what blocks.

- Skill: `keyvaluesoftwaresystems/go-review` (Agent Skill)
- Install (CLI): `npx get-skill add keyvaluesoftwaresystems/go-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/keyvaluesoftwaresystems/go-review/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: keyvaluesoftwaresystems (https://skillmd.com/u/keyvaluesoftwaresystems)
- Updated: 2026-11-11
- Page: https://skillmd.com/skills/keyvaluesoftwaresystems/go-review

---


# Go review checklist

Use this when writing or reviewing Go code. The severities say how serious a problem is; they are guidance for a finding's severity, not a verdict.

## Review Priorities

### CRITICAL -- Security
- **SQL injection**: String concatenation in `database/sql` queries
- **Command injection**: Unvalidated input in `os/exec`
- **Path traversal**: User-controlled file paths without `filepath.Clean` + prefix check
- **Race conditions**: Shared state without synchronization
- **Unsafe package**: Use without justification
- **Hardcoded secrets**: API keys, passwords in source
- **Insecure TLS**: `InsecureSkipVerify: true`

### CRITICAL -- Error Handling
- **Ignored errors**: Using `_` to discard errors
- **Missing error wrapping**: `return err` without `fmt.Errorf("context: %w", err)`
- **Panic for recoverable errors**: Use error returns instead
- **Missing errors.Is/As**: Use `errors.Is(err, target)` not `err == target`

### HIGH -- Concurrency
- **Goroutine leaks**: No cancellation mechanism (use `context.Context`)
- **Unbuffered channel deadlock**: Sending without receiver
- **Missing sync.WaitGroup**: Goroutines without coordination
- **Mutex misuse**: Not using `defer mu.Unlock()`

### HIGH -- Code Quality
- **Large functions**: Over 50 lines
- **Deep nesting**: More than 4 levels
- **Non-idiomatic**: `if/else` instead of early return
- **Package-level variables**: Mutable global state
- **Interface pollution**: Defining unused abstractions

### MEDIUM -- Performance
- **String concatenation in loops**: Use `strings.Builder`
- **Missing slice pre-allocation**: `make([]T, 0, cap)`
- **N+1 queries**: Database queries in loops
- **Unnecessary allocations**: Objects in hot paths

### MEDIUM -- Best Practices
- **Context first**: `ctx context.Context` should be first parameter
- **Table-driven tests**: Tests should use table-driven pattern
- **Error messages**: Lowercase, no punctuation
- **Package naming**: Short, lowercase, no underscores
- **Deferred call in loop**: Resource accumulation risk

## Diagnostic Commands

```bash
go vet ./...
staticcheck ./...
golangci-lint run
go build -race ./...
go test -race ./...
govulncheck ./...
```

