writing-go

Idiomatic Go prioritizes clarity, composition over inheritance, and stdlib-first design. This Skill guides you through established patterns—interface-centric design, error handling with context, and the options pattern—so your code aligns with Go conventions and remains maintainable across teams.

Go interfaces work best when small, focused, and consumer-defined. This Skill demonstrates interface-centric design patterns that decouple concerns, showing how to compose behavior through concrete types rather than deep inheritance hierarchies, making services easier to test and extend.

Table-driven testing in Go structures test cases as data slices, reducing boilerplate and improving coverage clarity. This Skill provides concrete examples of organizing test cases, handling edge cases, and validating behavior systematically across multiple input combinations.

Go's concurrency model uses goroutines and channels, but requires careful coordination. This Skill covers proven patterns for safe concurrent code—synchronization approaches, error propagation across goroutines, and resource cleanup—to prevent deadlocks and race conditions.

Go API design emphasizes explicit behavior, minimal dependencies, and clear error context. This Skill shows how to apply patterns like options for flexible configuration, composition for layering concerns, and structured error handling to create APIs that are intuitive and debuggable.

This Skill identifies anti-patterns—over-reliance on interfaces, hidden complexity through inheritance simulation, and unclear error handling—and contrasts them with idiomatic approaches, helping you recognize mistakes early and refactor with confidence.