Skip to content

muratmirgun/gophers

v0.1.0MIT

Production-grade Go programming skills for AI coding agents.

GitHubOpen Website

Changelog

All notable changes to gophers are recorded here. Format follows Keep a Changelog; versions follow Semantic Versioning.

Unreleased

Added

  • Nothing yet.

0.1.0 — 2026-06-05

Initial public release. 26 production-grade Go skills + 3 dispatchable subagents.

Added

Skills (26)

Fundamentals

  • go-naming — identifier naming, initialisms, no-Get rule
  • go-declarations — var/const/struct/map literals, iota enums
  • go-control-flow — if/for/switch, type switches, blank identifier
  • go-functions — file ordering, signatures, Printf-style helpers
  • go-data-structures — slices, maps, strings, container/* internals
  • go-packages — package layout, imports, blank imports
  • go-error-handling — sentinel/typed/opaque/joined strategies, %w, errors.Is/As
  • go-interfaces — consumer-owned interfaces, embedding, receivers
  • go-generics — when to introduce generics, constraints
  • go-functional-options — Option pattern for 3+ optional params
  • go-defensive — boundary copying, defer, time modelling, panic discipline
  • go-code-style — clarity > simplicity > concision > minimalism

Concurrency

  • go-context — context.Context propagation, deadlines, request values
  • go-concurrency — goroutines, channels, select, errgroup, leaks

Web & APIs

  • go-clean-architecture — framework-agnostic four-layer service template
  • go-grpc — .proto organisation, interceptors, status codes, bufconn
  • go-graphql — gqlgen vs graph-gophers, thin resolvers, DataLoader
  • go-swagger — swaggo/swag annotations, struct tags, CLI workflow

Data & Observability

  • go-database — sqlx/sqlc/pgx/GORM trade-offs, parametrisation, transactions
  • go-logging — slog, structured attrs, request-scoped context
  • go-observability — Prometheus, OpenTelemetry, metric ↔ trace correlation
  • go-performance — pprof decision tree, allocation reduction, benchmarking

Quality & Process

  • go-testing — table-driven, parallel, fakes, fuzzing, testing/synctest, goleak
  • go-linting — golangci-lint config, nolint discipline, CI gates
  • go-documentation — godoc grammar, Example tests, README/CHANGELOG
  • go-code-review — user-invocable /go-code-review for diff walk-through

Agents (3)

  • go-pr-reviewer — dispatch on Go PR diff; returns severity-grouped review
  • go-test-generator — dispatch on a Go file/symbol; returns complete *_test.go
  • go-arch-auditor — dispatch on a Go module; returns layer-violation report + refactor sequence

Infrastructure

  • .claude-plugin/plugin.json — Claude Code plugin manifest
  • .claude-plugin/marketplace.json — Claude Code marketplace listing
  • gemini-extension.json — Gemini CLI extension manifest
  • opencode.json — opencode plugin manifest
  • scripts/validate.sh — structural lint (frontmatter, headers, line counts)
  • CLAUDE.md — project context for AI agents
  • LICENSE — MIT

Project Standards (locked in this release)

  • SKILL.md files are ≤ 200 lines; descriptions ≤ 500 chars
  • Every skill ends with Core Rules, Anti-Patterns, Verification Checklist, References
  • Agent files are ≤ 250 lines with Input Contract → Process → Output Contract → Stop Conditions
  • All content is in English; content is paraphrased from upstream sources, not copied
  • Cross-references use relative paths (../go-X/SKILL.md)

Influences