{
"markdown": "# Agent Skills for production-ready Golang projects\n\nAI agent skills are reusable instruction sets that extend your coding assistant with domain-specific expertise, loaded on demand so they don't bloat your context. This repository covers **Go-specific** skills only (language, testing, security, observability, etc.); for dev workflow skills (git conventions, CI/CD, PR reviews) you'll want to add a separate skills plugin.\n\nFor non-Golang skills, please visit [cc-skills](https://github.com/samber/cc-skills).\n\n\n\n> [!IMPORTANT]\n> Bootstrapped with Claude Code by distilling my Go project commits. **Edited, tested, reviewed and reworked by a human**.\n>\n> **No AI slop here.** AI-made skills are useless.\n>\n> Built for Claude Code, Codex, Gemini, Copilot, Antigravity, Cursor...\n\n\n\n![\"image\"](\"https://github.com/user-attachments/assets/620b5835-c1ba-4ea9-bf47-2293b58b879e\")
\n\n## π How to use\n\n**Install with [skills](https://skills.sh/) CLI** (universal, works with any [Agent Skills](https://agentskills.io)-compatible tool):\n\n```bash\nnpx skills add https://github.com/samber/cc-skills-golang --all\n# or a single skill:\nnpx skills add https://github.com/samber/cc-skills-golang --skill golang-performance\n```\n\n\n\n\nClaude Code
\n\n```bash\n/plugin marketplace add samber/cc\n/plugin install cc-skills-golang@samber\n```\n\n \n\n\nOpenclaw
\n\nCopy skills into the cross-client discovery directory:\n\n```bash\ngit clone https://github.com/samber/cc-skills-golang.git ~/.openclaw/skills/cc-skills-golang\n# or in workspace:\ngit clone https://github.com/samber/cc-skills-golang.git ~/.openclaw/workspace/skills/cc-skills-golang\n```\n\n \n\n\nGemini CLI
\n\n```bash\ngemini extensions install https://github.com/samber/cc-skills-golang\n```\n\nUpdate with `gemini extensions update cc-skills-golang`.\n\n \n\n\nCursor
\n\nCopy skills into the cross-client discovery directory:\n\n```bash\ngit clone https://github.com/samber/cc-skills-golang.git ~/.cursor/skills/cc-skills-golang\n```\n\nCursor auto-discovers skills from `.agents/skills/` and `.cursor/skills/`.\n\n \n\n\nCopilot
\n\nCopy skills into the cross-client discovery directory:\n\n```bash\n/plugin install https://github.com/samber/cc-skills-golang\n# or\ngit clone https://github.com/samber/cc-skills-golang.git ~/.copilot/skills/cc-skills-golang\n```\n\nCopilot auto-discovers skills from `.copilot/skills/`.\n\n \n\n\nOpenCode
\n\nCopy skills into the cross-client discovery directory:\n\n```bash\ngit clone https://github.com/samber/cc-skills-golang.git ~/.agents/skills/cc-skills-golang\n```\n\nOpenCode auto-discovers skills from `.agents/skills/`, `.opencode/skills/`, and `.claude/skills/`.\n\n \n\n\nCodex (OpenAI)
\n\nClone into the cross-client discovery path:\n\n```bash\ngit clone https://github.com/samber/cc-skills-golang.git ~/.agents/skills/cc-skills-golang\n```\n\nCodex auto-discovers skills from `~/.agents/skills/` and `.agents/skills/`. Update with `cd ~/.agents/skills/cc-skills-golang && git pull`.\n\n \n\n\nAntigravity
\n\nClone and symlink into the cross-client discovery path:\n\n```bash\ngit clone https://github.com/samber/cc-skills-golang.git ~/.antigravity/skills/cc-skills-golang\n```\n\nUpdate with `cd ~/.antigravity/skills/cc-skills-golang && git pull`.\n\n \n\n\n\n## 𧩠Skills\n\nThese skills are designed as **atomic, cross-referencing units**. A skill may reference conventions defined in another (e.g. error-handling rules that affect logging live in `golang-error-handling`, not `golang-observability`). Installing only a subset will give you a partial and potentially inconsistent view of the guidelines. For best results, install all general-purpose skills together.\n\n```\n ββββββββββββββββββββββββββββββββββββββββββ\n β Golang Skills β\n ββββββββββββββββββββ¬ββββββββββββββββββββββ\n β\n βββββββββββββββββββ¬βββββββββββββββββββββββΌβββββββββββββββββββββββ\n βΌ βΌ βΌ βΌ\nββββββββββββββββ ββββββββββββββββ βββββββββββββββββββ ββββββββββββββββββββββββ\nβ Code Quality β β Arch & Designβ β QA & Perf β β Project Start β\nββββββββββββββββ€ ββββββββββββββββ€ βββββββββββββββββββ€ ββββββββββββββββββββββββ€\nβ code-style β β design-patt β β testing β β project-layout β\nβ naming β β concurrency β β benchmark β β popular-libs β\nβ error-handl β β context β β performance β β cli β\nβ safety β β dep-inject β β troubleshoot β β continuous-integ. β\nβ structs-ifaceβ β data-structs β β observability β β stay-updated β\nβ documentationβ β database β β β β dep-management β\nβ lint β β modernize β β β β gopls β\nβ security β β refactoring β β β β pkg-go-dev β\nββββββββββββββββ ββββββββββββββββ βββββββββββββββββββ ββββββββββββββββββββββββ\n\n βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ\n β Framework / Library Skills β\n ββββββββββββββββ¬βββββββββββββββββ¬βββββββββββββββ¬ββββββββββββββ¬ββββββββββββ€\n β APIs β DI β Frameworks β samber/* β Testing β\n ββββββββββββββββΌβββββββββββββββββΌβββββββββββββββΌββββββββββββββΌββββββββββββ€\n β grpc β google-wire β spf13-cobra β samber-lo β stretchr- β\n β graphql β uber-dig β spf13-viper β samber-mo β testify β\n β swagger β uber-fx β β samber-ro β β\n β β β β samber-do β β\n β β β β samber-hot β β\n β β β β samber-slog β β\n β β β β samber-oops β β\n ββββββββββββββββ΄βββββββββββββββββ΄βββββββββββββββ΄ββββββββββββββ΄ββββββββββββ\n\n```\n\n- βοΈ Recommended\n- β
Published\n- π· Work in progress\n- β To-do\n- β‘ Command available\n- π§ Ultrathink automatically\n- π€ Ultracode automatically\n- βοΈ Overridable (see doc below)\n- **Description (tok)**: weight of the `description` field from YAML frontmatter, always loaded into Claude's context for skill triggering\n- **SKILL.md (tok)**: weight of the full `SKILL.md` file loaded when the skill triggers\n- **Directory (tok)**: weight of all files in the skill directory (SKILL.md + referenced markdown files)\n\n**General purpose:**\n\n\n\n| | Skill | Flags | Error rate gap | Description (tok) | SKILL.md (tok) | Directory (tok) |\n| --- | --- | --- | --- | --- | --- | --- |\n| βοΈ | β
`golang-code-style` | β‘ π€ βοΈ | -40% | 114 | 2,358 | 2,974 |\n| βοΈ | β
`golang-data-structures` | β‘ | -39% | 93 | 2,608 | 6,327 |\n| βοΈ | β
`golang-database` | β‘ βοΈ | -38% | 97 | 2,721 | 7,243 |\n| βοΈ | β
`golang-design-patterns` | β‘ βοΈ | -37% | 80 | 2,694 | 9,400 |\n| βοΈ | β
`golang-documentation` | β‘ π€ βοΈ | -53% | 75 | 3,163 | 11,876 |\n| βοΈ | β
`golang-error-handling` | β‘ π€ βοΈ | -26% | 141 | 1,734 | 4,693 |\n| βοΈ | β
`golang-how-to` | β‘ | β | 184 | 4,210 | 17,583 |\n| βοΈ | β
`golang-modernize` | β‘ π€ | -43% | 104 | 3,486 | 15,145 |\n| βοΈ | β
`golang-naming` | β‘ βοΈ | -23% | 159 | 3,031 | 7,399 |\n| βοΈ | β
`golang-refactoring` | β‘ π§ π€ βοΈ | β | 245 | 3,835 | 20,392 |\n| βοΈ | β
`golang-safety` | β‘ | -58% | 78 | 2,614 | 5,384 |\n| βοΈ | β
`golang-testing` | β‘ π§ π€ βοΈ | -32% | 115 | 4,270 | 8,822 |\n| βοΈ | β
`golang-troubleshooting` | β‘ π§ π€ | -32% | 173 | 2,993 | 18,035 |\n| βοΈ | β
`golang-security` | β‘ π§ π€ | -32% | 85 | 3,187 | 21,623 |\n| | β
`golang-benchmark` | β‘ π§ | -50% | 102 | 3,153 | 33,396 |\n| | β
`golang-cli` | β‘ | -43% | 125 | 2,338 | 6,153 |\n| | β
`golang-concurrency` | β‘ π€ βοΈ | -39% | 72 | 2,196 | 6,826 |\n| | β
`golang-context` | β‘ βοΈ | -34% | 82 | 1,211 | 4,021 |\n| | β
`golang-continuous-integration` | β‘ | -59% | 177 | 3,542 | 12,804 |\n| | β
`golang-dependency-injection` | β‘ π€ βοΈ | -47% | 178 | 3,016 | 5,287 |\n| | β
`golang-dependency-management` | β‘ | -54% | 77 | 2,407 | 5,545 |\n| | β
`golang-structs-interfaces` | β‘ βοΈ | -35% | 111 | 3,076 | 3,076 |\n| | β
`golang-lint` | β‘ π€ | -41% | 98 | 1,877 | 6,295 |\n| | β
`golang-observability` | β‘ π€ βοΈ | -37% | 164 | 3,128 | 19,583 |\n| | β
`golang-performance` | β‘ π§ π€ | -39% | 130 | 2,226 | 19,820 |\n| | β
`golang-gopls` | β‘ | β | 219 | 2,317 | 12,312 |\n| | β
`golang-pkg-go-dev` | β‘ | β | 170 | 3,442 | 5,386 |\n| | β
`golang-popular-libraries` | β‘ | -30% | 156 | 1,181 | 5,093 |\n| | β
`golang-project-layout` | β‘ | -38% | 105 | 1,761 | 6,257 |\n| | β
`golang-stay-updated` | β‘ | -56% | 44 | 1,802 | 1,802 |\n\n**Tools:**\n\n| Skill | Flags | Error rate gap | Description (tok) | SKILL.md (tok) | Directory (tok) |\n| --- | --- | --- | --- | --- | --- |\n| β
`golang-google-wire` | β‘ | -16% | 122 | 2,670 | 7,400 |\n| β
`golang-graphql` | | -16% | 76 | 3,070 | 7,941 |\n| β
`golang-grpc` | β‘ | -41% | 70 | 2,341 | 5,157 |\n| β
`golang-spf13-cobra` | β‘ | β | 176 | 2,580 | 7,351 |\n| β
`golang-spf13-viper` | β‘ | β | 170 | 2,551 | 7,098 |\n| β
`golang-swagger` | β‘ | β | 144 | 2,342 | 3,347 |\n| β
`golang-uber-dig` | β‘ | -10% | 107 | 2,585 | 6,257 |\n| β
`golang-uber-fx` | β‘ | -5% | 118 | 2,825 | 7,060 |\n| β
`golang-samber-do` | β‘ | -81% | 71 | 2,145 | 3,660 |\n| β
`golang-samber-hot` | β‘ | -54% | 119 | 1,986 | 7,416 |\n| β
`golang-samber-lo` | β‘ | -40% | 166 | 2,610 | 10,288 |\n| β
`golang-samber-mo` | β‘ π§ | -48% | 82 | 2,967 | 11,382 |\n| β
`golang-samber-oops` | β‘ | -59% | 70 | 2,544 | 2,856 |\n| β
`golang-samber-ro` | β‘ π§ | -50% | 153 | 2,976 | 11,192 |\n| β
`golang-samber-slog` | β‘ | -19% | 119 | 3,120 | 9,842 |\n| β `golang-temporal` | | β | 0 | 0 | 0 |\n| β
`golang-stretchr-testify` | β‘ | -47% | 92 | 1,858 | 2,677 |\n\n## π§ͺ Skill evaluations\n\n| | With Skill | Without Skill | Delta |\n| ----------- | ------------------- | ------------------- | --------- |\n| **Overall** | **3348/3439 (97%)** | **1957/3439 (57%)** | **+40pp** |\n\nSee [EVALUATIONS.md](./EVALUATIONS.md) for the full per-skill breakdown.\n\n## π Skills description\n\n### Code Quality\n\n#### `golang-code-style`\n\nGo code formatting and conventions. gofmt, goimports, linting rules, comment conventions, and project-level style consistency. Overridable by company skills.\n\n#### `golang-documentation`\n\nGo documentation standards. Package docs, godoc conventions, code comments, example functions, README structure, and API reference generation. Overridable.\n\n#### `golang-error-handling`\n\nGo error handling best practices. Error creation, wrapping with fmt.Errorf and errors.Is/As, sentinel errors, custom error types, error codes, and panic recovery. Overridable.\n\n#### `golang-lint`\n\nGo linting best practices and golangci-lint configuration. Presets, custom rules, CI integration, inline suppression, and output interpretation.\n\n#### `golang-naming`\n\nGo naming conventions across all identifier types. Packages, constructors, structs, interfaces, constants, errors, receivers, acronyms, test functions. Covers MixedCaps rules, Get-prefix, and utils/helpers anti-patterns. Overridable.\n\n#### `golang-safety`\n\nDefensive Go coding. Prevents panics, silent data corruption, and runtime bugs. nil safety, append aliasing, map concurrent access, float comparison, zero-value design, numeric overflow.\n\n#### `golang-security`\n\nGo security best practices. Injection prevention (SQL, command, XSS), cryptography, filesystem/network safety, secrets management, cookie security, and tool configuration. Audit and review modes.\n\n#### `golang-structs-interfaces`\n\nGo struct and interface design. Composition, embedding, type assertions, interface segregation, struct tags (JSON/YAML/DB), pointer vs value receivers. Overridable.\n\n### Architecture & Design\n\n#### `golang-concurrency`\n\nGo concurrency patterns. Goroutines, channels, sync primitives, context cancellation, worker pools, fan-out/fan-in, pipelines. Overridable.\n\n#### `golang-context`\n\nIdiomatic context.Context usage. Creation, cancellation, timeouts, values, propagation patterns, and common anti-patterns. Overridable.\n\n#### `golang-data-structures`\n\nGo data structures internals and usage. Slices (capacity growth, append aliasing), maps, channels, sync primitives, and when to use each.\n\n#### `golang-database`\n\nGo database access patterns. Parameter binding, connection pooling, transactions, migrations, sqlboiler/sqlc code generation, query builders. Overridable.\n\n#### `golang-dependency-injection`\n\nDependency injection patterns in Go. Constructor injection, interface-based DI, wire/dig/fx comparison, and when DI is worth the complexity. Overridable.\n\n#### `golang-design-patterns`\n\nIdiomatic Go design patterns. Functional options, constructors, builder pattern, middleware chains, circuit breaker, and architecture guides with file trees and code. Overridable.\n\n#### `golang-modernize`\n\nModernize Go code to use recent language features. Range-over-int, min/max builtins, iterators, slices/maps/cmp/slog stdlib packages, testing patterns (t.Context, b.Loop, synctest), and tooling upgrades.\n\n#### `golang-refactoring`\n\nSafe, at-scale refactoring process for existing Go code. Coverage-adaptive safety net, tool-driven behavior-preserving transforms (gopls Rename/Inline/Extract, gofmt -r, eg, gopatch), the Fowler catalog mapped to Go, breaking import cycles, type-alias gradual code repair, and a human-in-the-loop workflow of staged PRs on a refactoring branch.\n\n### QA & Performance\n\n#### `golang-benchmark`\n\nGo benchmarking, profiling, and performance measurement. pprof, trace, CPU/memory/block profiles, flame graphs, benchmark comparison (benchstat), continuous profiling.\n\n#### `golang-observability`\n\nGo production observability. Structured logging (slog), Prometheus metrics, OpenTelemetry tracing, pprof profiling, RUM tracking, alerting, Grafana dashboards. Overridable.\n\n#### `golang-performance`\n\nGo performance optimization. Allocation reduction, CPU efficiency, memory layout, GC tuning, pooling, caching, hot-path optimization. Review and hot-path modes.\n\n#### `golang-testing`\n\nProduction-ready Go tests. Table-driven tests, fuzzing, fixtures, goroutine leak detection (goleak), snapshot testing, code coverage, integration tests, parallel tests. Overridable.\n\n#### `golang-troubleshooting`\n\nSystematic Go debugging methodology. Common pitfalls, test-driven debugging, pprof capture, Delve debugger, race detection, GODEBUG tracing, production debugging.\n\n### Project Setup\n\n#### `golang-cli`\n\nGo CLI application development. Project layout, exit codes, signal handling, I/O patterns, argument parsing, and terminal UX.\n\n#### `golang-continuous-integration`\n\nCI/CD pipeline configuration for Go projects using GitHub Actions. Build, test, lint, and release workflows.\n\n#### `golang-dependency-management`\n\nGo module dependency strategies. go.mod conventions, versioning, replace directives, tool dependencies, and multi-module workspaces.\n\n#### `golang-gopls`\n\nSemantic code intelligence for your local build via `gopls`, the official Go language server. Go-to-definition, find references, call/implementation hierarchy, workspace symbol search, diagnostics, safe rename, and refactors (extract/inline/fill/rewrite). Reachable via gopls's own MCP server, Claude Code's native `LSP` tool, or the `gopls` CLI.\n\n#### `golang-pkg-go-dev`\n\nGo package and module exploration via `godig`, a pkg.go.dev API client (CLI + MCP server). Package docs, API references, symbols, code examples, versions, importers, licenses, and known vulnerabilities. Prefer over Context7 for Go packages.\n\n#### `golang-popular-libraries`\n\nCurated recommendations for production-ready Go libraries and frameworks. When the stdlib is enough vs when to reach for a package.\n\n#### `golang-project-layout`\n\nGo project structure and workspace setup. cmd/internal/pkg conventions, monorepo layout, CLI project structure, and when to keep things flat.\n\n#### `golang-stay-updated`\n\nResources to stay current with Go. Official channels, community hubs, key people to follow, and learning resources.\n\n### APIs\n\n#### `golang-graphql`\n\nGraphQL API development in Go using gqlgen/graphql-go. Schema definition, resolvers, subscriptions, dataloader, and federation.\n\n#### `golang-grpc`\n\ngRPC in Go. Protobuf organization, service definitions, streaming, interceptors, error codes, and code generation workflow.\n\n#### `golang-swagger`\n\nOpenAPI/Swagger docs with swaggo/swag. Annotation comments, code generation, framework integrations (gin, echo, fiber, chi), security definitions.\n\n### Dependency Injection\n\n#### `golang-google-wire`\n\nCompile-time dependency injection with google/wire. Provider sets, injector generation, wire.Build, and structured DI patterns.\n\n#### `golang-uber-dig`\n\nReflection-based DI with uber-go/dig. Provide/Invoke, dig.In/dig.Out, named values, value groups, optional dependencies, and Decorate.\n\n#### `golang-uber-fx`\n\nApplication framework with uber-go/fx. fx.New, fx.Provide/Invoke, fx.Module, lifecycle hooks, fx.Annotate, fx.Decorate, signal-aware Run.\n\n### Frameworks\n\n#### `golang-spf13-cobra`\n\nCLI command trees with spf13/cobra. Command hierarchy, RunE hooks, flag management, shell completion, usage templates, and testing with SetArgs.\n\n#### `golang-spf13-viper`\n\nLayered configuration with spf13/viper. Flag > env > file > KV > default precedence, BindPFlag, hot reload, test isolation, and remote KV integration.\n\n### samber/\\*\n\n#### `golang-samber-do`\n\nDependency injection with samber/do. Type-safe service containers, lifecycle management, scopes, health checks, and graceful shutdown.\n\n#### `golang-samber-hot`\n\nIn-memory caching with samber/hot. 9 eviction algorithms (LRU, LFU, TinyLFU, W-TinyLFU, S3FIFO, ARC, SIEVE...), TTL, loaders, sharding, stale-while-revalidate, Prometheus metrics.\n\n#### `golang-samber-lo`\n\nFunctional programming helpers with samber/lo. 500+ type-safe generic functions for slices, maps, channels, strings. Immutable (lo), parallel (lop), mutable (lom), iterators (loi), SIMD.\n\n#### `golang-samber-mo`\n\nMonadic types with samber/mo. Option, Result, Either, Future, IO, Task, State for type-safe nullable values, error handling, and functional composition.\n\n#### `golang-samber-oops`\n\nStructured error handling with samber/oops. Error builders, stack traces, error codes, context attributes, public vs developer messages, panic recovery, and APM integration.\n\n#### `golang-samber-ro`\n\nReactive streams with samber/ro. 150+ type-safe operators, cold/hot observables, 5 subject types, 40+ plugins, automatic backpressure, and Go context integration.\n\n#### `golang-samber-slog`\n\nStructured logging pipeline with samber/slog-\\*\\*\\*\\* packages. Multi-handler routing (slog-multi), sampling, formatting, HTTP middleware, and 20+ backend sinks.\n\n### Testing\n\n#### `golang-stretchr-testify`\n\nTesting with stretchr/testify. assert, require, mock, and suite packages. Assertions, mock expectations, argument matchers, suite lifecycle, and custom matchers.\n\n## π΅ Use in CI for AI-driven reviews\n\nAdd AI agents as PR reviewers alongside traditional static analysis. When configured with this skill plugin, the agent applies the relevant Go skills per review area β catching architectural drift, logic bugs, and concurrency hazards that linters cannot detect.\n\nSee [GOLANG-AI-DRIVEN-REVIEW.md](./GOLANG-AI-DRIVEN-REVIEW.md) for full setup instructions (Claude Code Action and GitHub Copilot).\n\n## π― Tuning Skill Triggers\n\nIf a skill triggers too often or not often enough, please [open an issue](https://github.com/samber/cc-skills-golang/issues) suggesting a description change. The `description` field in SKILL.md frontmatter is the primary triggering mechanism β small wording adjustments can significantly improve trigger accuracy. Some `SKILL.md` files might have a `When to use` section which is another level of exclusion. Finally, `SKILL.md` files are an entrypoint for lazy loading references with deep knowledge located in `references/`.\n\n## π Overlap\n\nClaude reports very little overlap between skills in this repo, thanks to cross-reference. I suggest enabling most of the skills and leveraging lazy loading. The recommended βοΈ skills load ~1,100 tokens of descriptions at startup; full skill content is only pulled in when relevant. Note:\n\n- I estimate that 50% of `golang-naming` and `golang-code-style` overlap with linters (golangci-lint).\n- A large part of the security rules in `golang-security` have been distilled from the Bearer (SAST) checklist. The skill is still useful for methodology.\n- If your team has its own conventions, create a company skill and declare the override explicitly near the top of its body: `This skill supersedes samber/cc-skills-golang@golang-naming skill for [company] projects.` Skills marked βοΈ in the table above support this mechanism.\n\n## βοΈ Contribute\n\n- **100 tokens per skill description** - what? when to use this skill?\n- **1.000β2.500 tokens per SKILL.md** β keep the main file focused on essentials\n- **Use secondary markdown files for depth** β reference them from SKILL.md with relative links (e.g., `[Logging](./logging.md)`). Claude reads these on demand when the topic is relevant, so they don't count against the context budget until needed\n- **Up to 10.000 tokens** for full skill and secondary files\n- **2β4 skills loaded simultaneously** in a typical session β design skills to coexist\n- **Stay below ~10k tokens of total loaded SKILL.md** anytime to avoid degrading response quality\n\nFor more guidelines, please check `CLAUDE.md`.\n\n## π« Fuel the Revolution\n\n- βοΈ **Star this repo** - Your star powers the caffeine engine!\n- βοΈ **Buy me a coffee** - I'll literally use it to build more skills while drinking actual coffee\n\n[](https://github.com/sponsors/samber)\n\n## π License\n\nCopyright Β© 2026 [Samuel Berthe](https://github.com/samber).\n\nThis project is under [MIT](./LICENSE) license.\n",
"bytes": 22449,
"sha": "966edf79feefe125133cb7f156171798320785bf4292bd2e16793cf1e138ec67",
"repo_slug": "samber/cc-skills-golang",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/skl_samber_cc_skills_golang_golang_samber_ho_a3a57b95/readme"
}