skillfed

go-code-review

Go Code Review systematically audits Go source files against idiomatic patterns, error handling practices, concurrency safety, and common pitfalls. The skill applies version-aware guidance based on your project's Go baseline, covering generics, structured logging, and loop variable semantics. It follows a structured workflow that reads full context, applies targeted checklists, and verifies findings before reporting issues with severity calibration.

Go Code Review examines Go code for idiomatic patterns, error handling, concurrency safety, and common mistakes across Go 1.18+ versions.

AI-generated summary based on this skill's SKILL.md

74 10 Apache-2.0 updated by existential-birds

Install

existential-birds/beagle/go-code-review · repository language: TypeScript

CLI (skillfed)coming soon
git clone https://github.com/existential-birds/beagle
cp -r beagle/plugins/beagle-go/skills/go-code-review ~/.claude/skills/go-code-review

Frequently asked questions

AI-generated answers based on this skill's SKILL.md and metadata

What does go-code-review check Go code for?

go-code-review systematically audits Go source files against idiomatic patterns, error handling practices, concurrency safety, and common pitfalls. The skill applies version-aware guidance based on your project's Go baseline, covering generics, structured logging, and loop variable semantics.

How does go-code-review detect goroutine safety issues?

go-code-review includes targeted detection for goroutine leaks and concurrency safety issues. It analyzes goroutine spawning patterns, channel usage, synchronization primitives, and lifecycle management to identify potential race conditions and resource leaks in concurrent code.

Can go-code-review review go error handling best practices?

Yes. go-code-review checks error handling and wrapping in Go files with high priority, examining error propagation patterns, proper use of error wrapping with fmt.Errorf, and adherence to Go error handling idioms throughout your codebase.

Does go-code-review handle Go version-specific features?

go-code-review validates Go version-specific features and semantics, including Go 1.22 loop variable changes, generics syntax, and structured logging with slog. It applies version-aware guidance tailored to your project's Go baseline.

What resource cleanup issues can go-code-review identify?

go-code-review ensures proper resource cleanup and lifecycle management by reviewing defer statements, file handle closures, connection pooling, and context propagation. It detects missing cleanup calls and improper resource lifecycle patterns.

How does go-code-review report its findings?

go-code-review follows a structured workflow that reads full context, applies targeted checklists, and verifies findings before reporting issues with severity calibration. This systematic approach ensures accurate, actionable feedback on code quality and safety.

SKILL.md

rendered from the published skill — quoted content, verbatim

Go Code Review

Review Workflow

Follow this sequence in order. Do not emit findings until every Pass below is satisfied.

  1. Baseline go.mod — Open go.mod and read the go directive.
    Pass: You can state the exact go X.YY value (in the review preamble or working notes). Apply version-gated advice only when it matches this baseline (loop capture pre-1.22, slog/structured logging from 1.21, errors.Join from 1.20).

  2. Read surrounding code — For each changed .go file, read full functions or logical units that contain the edits, not only the diff hunk.
    Pass: At least one full enclosing function (or package-level init/var block) containing the change was read per changed file.

  3. Scope the checklist — Decide which Review Checklist blocks apply (error handling, concurrency,

(truncated - see the full file via the links below)

Read as markdown · JSON record · Browse the source repository

File tree — 5 files
plugins/beagle-go/skills/go-code-review/SKILL.md
plugins/beagle-go/skills/go-code-review/references/common-mistakes.md
plugins/beagle-go/skills/go-code-review/references/concurrency.md
plugins/beagle-go/skills/go-code-review/references/error-handling.md
plugins/beagle-go/skills/go-code-review/references/interfaces.md

Related skills

Tags

static-analysis best-practices concurrency-safety resource-management error-patterns code-quality golang-idioms version-aware