How does this skill improve my Go code?

It enforces standard community patterns such as wrapping errors with %w, defining small interfaces in consumer packages, and using context for cancellation and timeouts.

Does this skill help with race conditions?

Yes, it provides patterns for race-safe concurrency, including bounded concurrency with semaphores and proper context propagation to prevent goroutine leaks.

What are the main anti-patterns it prevents?

It identifies and helps avoid goroutine leaks, monolithic interfaces with too many methods, global singletons, and the overuse of reflection or generic types.

Does it support dependency injection?

Yes, it promotes constructor-based dependency injection using interfaces, making your code significantly easier to unit test with mocks.

When should I use the go-idioms skill?

Use it during code reviews, when architecting new Go projects, or when refactoring complex logic into smaller, more testable packages.

Go Idioms & Best Practices

Name: Go Idioms & Best Practices
Author: phrazzld

byphrazzld

•

API Development

Implements clean, idiomatic Go patterns for concurrency, error handling, and package architecture.

About

This skill provides Claude with deep expertise in idiomatic Go (Golang) development, focusing on the principle of 'boring, explicit, and race-safe' code. It guides the implementation of core Go patterns such as wrapping errors with context, defining interfaces at the consumer level, and managing structured concurrency via context propagation. Whether you are refactoring legacy code, designing a new service architecture, or troubleshooting race conditions, this skill ensures your Go projects remain maintainable, testable, and aligned with industry standards.

Key Features

2 GitHub stars
Context-aware error wrapping and propagation
Race-safe concurrency with bounded semaphores
Consumer-side interface design and composition
Detection and remediation of common Go anti-patterns
Idiomatic package structure and dependency injection

Use Cases

Refactoring monolithic Go files into modular, domain-driven packages
Designing testable services using constructor-based dependency injection
Implementing robust error handling chains that preserve underlying types

About

Key Features

2 GitHub stars
Context-aware error wrapping and propagation
Race-safe concurrency with bounded semaphores
Consumer-side interface design and composition
Detection and remediation of common Go anti-patterns
Idiomatic package structure and dependency injection

Use Cases

Refactoring monolithic Go files into modular, domain-driven packages
Designing testable services using constructor-based dependency injection
Implementing robust error handling chains that preserve underlying types