go-api-design

npx skills add eduardo-sl/go-agent-skills

[!IMPORTANT] An agent is only as good as the context you hand it. Without Go-specific guidance it writes Java-flavoured Go: naked err returns, producer-side interfaces, goroutines nobody stops, interface{} where generics belong.

These 33 skills encode how experienced Go engineers actually work — grounded in the Uber Go Style Guide, Effective Go, and Go Code Review Comments — and they load on demand, so they cost nothing until they are relevant.

---

🚀 Install

Works with Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, OpenCode, Cline, and 37+ more agents via the npx skills CLI.

# Everything, interactive — picks up the agents you have installed
npx skills add eduardo-sl/go-agent-skills

# Look before you leap
npx skills add eduardo-sl/go-agent-skills --list

# Just the ones you want
npx skills add eduardo-sl/go-agent-skills --skill go-code-review --skill go-defensive-coding

# Globally, for every project
npx skills add eduardo-sl/go-agent-skills -g

# Non-interactive, for CI
npx skills add eduardo-sl/go-agent-skills --all -y

/plugin marketplace add eduardo-sl/go-agent-skills
/plugin install go-agent-skills@eduardo-sl

Or drop them straight in: npx skills add eduardo-sl/go-agent-skills -a claude-code

npx skills add eduardo-sl/go-agent-skills -a cursor

Cursor auto-discovers skills from .cursor/skills/ and .agents/skills/.

npx skills add eduardo-sl/go-agent-skills -a copilot

Copilot auto-discovers skills from .github/skills/.

npx skills add eduardo-sl/go-agent-skills -a codex

Codex auto-discovers skills from ~/.agents/skills/ and .agents/skills/.

npx skills add eduardo-sl/go-agent-skills -a windsurf
npx skills add eduardo-sl/go-agent-skills -a opencode
npx skills add eduardo-sl/go-agent-skills -a cline

git clone https://github.com/eduardo-sl/go-agent-skills.git
./go-agent-skills/scripts/install.sh /path/to/your-go-project --agent claude

# See what it would do first
./go-agent-skills/scripts/install.sh /path/to/project --agent claude --dry-run

# Symlink instead of copy, to stay in sync with the repo
./go-agent-skills/scripts/install.sh /path/to/project --agent claude --symlink

mkdir -p .claude/skills && cp -r go-agent-skills/skills/*/* .claude/skills/   # Claude Code
mkdir -p .cursor/skills && cp -r go-agent-skills/skills/*/* .cursor/skills/   # Cursor
mkdir -p .github/skills && cp -r go-agent-skills/skills/*/* .github/skills/   # Copilot
mkdir -p .agents/skills && cp -r go-agent-skills/skills/*/* .agents/skills/   # Codex / OpenCode

npx skills check      # anything out of date?
npx skills update     # bring them current
npx skills list       # what is installed
npx skills remove go-performance-review

---

🗺 The map

                            ┌───────────────────────────┐
                            │      go-skills-router     │  ← "which skill is this?"
                            └─────────────┬─────────────┘
                                          │
   ┌──────────────┬──────────────┬────────┴─────┬──────────────┬──────────────┐
   ▼              ▼              ▼              ▼              ▼              ▼
┌────────────┐┌────────────┐┌────────────┐┌────────────┐┌────────────┐┌────────────┐
│Code Quality││Architecture││   Data     ││Safety&Perf ││  Testing   ││  Workflow  │
├────────────┤├────────────┤├────────────┤├────────────┤├────────────┤├────────────┤
│coding-stds ││arch-review ││ database   ││concurrency ││test-quality││ dep-audit  │
│code-review ││proj-layout ││            ││  -review   ││test-table  ││ ci         │
│error-handl ││iface-design││            ││security    ││  -driven   ││ refactoring│
│context     ││api-design  ││            ││  -audit    ││            ││ semantic   │
│modernize   ││openapi     ││            ││defensive   ││            ││  -tools    │
│data-structs││graphql     ││            ││  -coding   ││            ││ binary-size│
│docs        ││grpc        ││            ││performance ││            ││ skills     │
│            ││design-patt ││            ││  -review   ││            ││  -router   │
│            ││dep-inject  ││            ││observabil. ││            ││ git-commit │
│            ││cli         ││            ││troublesh.  ││            ││            │
└────────────┘└────────────┘└────────────┘└────────────┘└────────────┘└────────────┘

Unsure which one applies? That is what go-skills-router is for — it maps a task to the skill that owns it, and draws the boundary when two overlap.

---

📊 Catalogue

Skills load automatically from context. You can also invoke one directly: /go-code-review.

Reading the columns. Desc is the description weight, loaded at startup for every skill — it is what makes a skill trigger. SKILL.md is what loads when one fires. Tree includes the references/ files, which load only when the skill sends the agent to them. 📚 marks a skill with reference files. All figures are approximate tokens (bytes ÷ 4).

Code Quality