Enforce Go receiver selection, named returns, and safe defer usage.
npx skills add https://github.com/v0lka/skills --skill go-functions-methods
Please help me install this Agent Skill. Skill: go-functions-methods Source: https://github.com/v0lka/skills/tree/main/development/idiomatic-go/go-functions-methods Command: npx skills add https://github.com/v0lka/skills --skill go-functions-methods
Go developers often struggle to write correct and maintainable functions and methods, suffering from inconsistent receiver choices, unclear return parameters, and unsafe defer usage. This Skill provides clear guidelines to improve correctness, readability, and maintainability of Go code.
Follow these guidelines when creating or refactoring a Go type to ensure proper receiver choice, named results, and safe defer usage.
High-intent search queries and answers about installing and using this skill.
Choose pointer receivers in Go methods when the method mutates the receiver or the type is large, and use value receivers for immutable, small types to reflect correct semantics and improve maintainability.
Use named return parameters in Go functions to clarify return values, but avoid naked returns in complex functions where they reduce readability. Named returns are best used to document function signatures and simplify defer blocks.
Design Go functions to accept io.Reader instead of filenames to keep code flexible and testable. This allows you to easily pass mock readers in unit tests rather than relying on actual file system operations.
Go defer semantics capture function arguments and receiver values immediately. Use safe defer usage by capturing variables in closures carefully to prevent subtle bugs related to loop variables or mutated state during execution.
Inconsistent Go methods often stem from mixing pointer and value receivers across types. Enforcing strict receiver selection rules ensures consistent behavior across callers and prevents subtle bugs during real-world refactoring.
LuigiAPCPereiraGenerate and review Go project documentation, including godoc comments, READMEs, and CHANGELOGs.
DarkMonkDevRun unit, integration, and end-to-end tests in isolated containers.
tamago0224Enforce idiomatic Go code style and clarity across source files.
MolcajeteAIEnforce godoc conventions for Go package, function, and type documentation.
