google-go-style
A Claude Code plugin that ships a single skill: google-go-style. The skill
codifies the Google Go Style Guide
into actionable rules that Claude consults whenever you write, review, or
refactor Go code.
About
This skill encodes my interpretation of the
Google Go Style Guide for use with
Claude Code. The upstream guide is © Google LLC, licensed under
CC-BY 3.0. This skill (SKILL.md
and supporting files under plugins/google-go-style/skills/google-go-style/)
is my own work, licensed Apache-2.0.
What it does
When loaded, Claude follows the rules in SKILL.md on every Go change. Topics
covered:
- Naming (receivers, initialisms, repetition, test doubles, package names)
- Error handling (
%v vs %w, sentinels, RPC boundaries, errors.Is / As)
- Panics,
log.Fatal, and error return — when each applies
- Test discipline (no assertion libraries,
t.Error vs t.Fatal, goroutines)
- API design (option struct vs variadic options, interfaces, channel direction)
- Documentation conventions
- Package layout, imports,
internal/
- Variable declaration, zero values, strings, shadowing
SKILL.md is the quick-reference. Eight files under references/ carry the
detailed rules; Claude loads them on demand.
Why
The upstream guide is large and not optimised for being consulted on every
file edit. This skill is a digest — it puts the rules Claude needs on the hot
path and leaves the long-form material as references it can fetch when a
specific topic comes up.
Install
Claude Code (native plugin)
claude plugin marketplace add cicdteam/google-go-style
claude plugin install google-go-style@cicdteam
Cross-agent (Claude Code, Cursor, Codex, OpenCode, …)
npx skills add cicdteam/google-go-style
After install, Claude loads the skill automatically when triggers in its
description match (writing or reviewing Go, error handling, panics, tests, API
design, naming, package layout, variables and strings).
Semver
Versions follow Semantic Versioning. Breaking changes
to the rule set or plugin layout bump the major; additive rule changes bump
the minor; fixes bump the patch. See CHANGELOG.md for per-release notes.
Contributing
Issues are welcome — particularly if you spot a rule that contradicts the
upstream guide or that's no longer current. PRs are accepted on a best-effort
basis; please open an issue first for non-trivial changes so we can agree on
scope.
Attribution
The skill is a derivative work based on the
Google Go Style Guide, © Google
LLC, licensed under
CC-BY 3.0. See NOTICE for
the full attribution.
License
Apache-2.0. See LICENSE.
