writing-go — скилл для Claude Code: идиоматичный Go 1.25+
Скилл writing-go задаёт агенту правила написания Go: стандартная библиотека вместо зависимостей, конкретные типы, ошибки с контекстом, табличные тесты.
MIT 110 установок ★ 17 обновлён 2026-10-14
npx skills add julianobarbosa/claude-code-skills --skill writing-go -a claude-codeЧто делает writing-go
Скилл задаёт правила, по которым агент пишет код на Go: сначала стандартная библиотека, внешние зависимости — только с обоснованием; интерфейсы объявляются у потребителя, функции возвращают конкретные структуры. Внутри короткие шаблоны на обёртку ошибок через fmt.Errorf с %w, конструктор с опциями вида NewServer(addr string, opts ...Option) и табличные тесты, плюс справочники PATTERNS.md, TESTING.md и CLI.md для подробностей.
Отдельный раздел — возможности Go 1.25: testing/synctest с имитацией часов, экспериментальный encoding/json/v2 под GOEXPERIMENT=jsonv2, runtime/trace.FlightRecorder, автоподстройка GOMAXPROCS под лимиты cgroup и экспериментальный сборщик GreenTea. Есть список ловушек: defer запоминает аргументы в момент вызова, отправка в nil-канал блокируется навсегда, объект из sync.Pool может исчезнуть до следующего Put.
Примеры тестов вызывают require и assert, поэтому без testify в модуле эти сниппеты не соберутся. Доступ к инструментам у скилла ограничен Read, Bash, Grep и Glob.
Какие задачи решает
- договориться с агентом, что интерфейсы объявляются у потребителя
- обернуть ошибку с контекстом через
%w - собрать конструктор с функциональными опциями
- переписать проверки на табличный вид
- разобраться, что в Go 1.25 включается через
GOEXPERIMENT
Примеры запросов агенту
- Напиши HTTP-клиент на Go 1.25 по правилам скилла: только стандартная библиотека, ошибки оборачивай через
%w. - Отрефактори этот пакет — интерфейсы перенеси к потребителю, а функции пусть возвращают конкретные структуры.
- Прогони мой код по списку ловушек и предложи табличные тесты для
Process.
Как установить writing-go
1Через Skills CLI (Vercel)
npx skills add julianobarbosa/claude-code-skills --skill writing-go -a claude-code2Вручную: положить файлы
~/.claude/skills/writing-go/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/writing-go/
1Через Skills CLI (Vercel)
npx skills add julianobarbosa/claude-code-skills --skill writing-go -a codex2Вручную: положить файлы
.agents/skills/writing-go/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add julianobarbosa/claude-code-skills --skill writing-go -a cursor2Вручную: положить файлы
.cursor/skills/writing-go/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install julianobarbosa/claude-code-skills skills/writing-go2Вручную: положить файлы
.github/skills/writing-go/SKILL.md1Через Skills CLI (Vercel)
npx skills add julianobarbosa/claude-code-skills --skill writing-go -a gemini-cli2Командой платформы
gemini skills install https://github.com/julianobarbosa/claude-code-skills --path skills/writing-goВручную: положить файлы
.devin/skills/writing-go/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add julianobarbosa/claude-code-skills --skill writing-go -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о writing-go
Как установить writing-go в Claude Code?
Выполните npx skills add julianobarbosa/claude-code-skills --skill writing-go -a claude-code. Файл скилла окажется по пути ~/.claude/skills/writing-go/SKILL.md.
Что делает writing-go?
Задаёт агенту правила идиоматичного Go 1.25+ при написании и разборе кода: стандартная библиотека вместо зависимостей, конкретные типы возврата, ошибки с контекстом, табличные тесты. Рядом лежат справочники по паттернам, тестам и CLI.
Что нужно, чтобы примеры тестов заработали?
Сниппеты вызывают require и assert из testify, так что библиотека должна быть в модуле. В TESTING.md разобраны testify и генерация моков через mockery.
Исходный текст
SKILL.md · MIT
---
name: writing-go
description: Idiomatic Go 1.25+ development. Use when writing Go code, designing APIs, discussing Go patterns, or reviewing Go implementations. Emphasizes stdlib, concrete types, simple error handling, and minimal dependencies.
allowed-tools: Read, Bash, Grep, Glob
---
# Go Development (1.25+)
## Core Principles
- **Stdlib first**: External deps only when justified
- **Concrete types**: Define interfaces at consumer, return structs
- **Composition**: Over inheritance, always
- **Fail fast**: Clear errors with context
- **Simple**: The obvious solution is usually correct
## Quick Patterns
### Error Handling
```go
if err := doThing(); err != nil {
return fmt.Errorf("do thing: %w", err)
}
```
### Struct with Options
```go
type Server struct {
addr string
timeout time.Duration
}
func NewServer(addr string, opts ...Option) *Server {
s := &Server{addr: addr, timeout: 30 * time.Second}
for _, opt := range opts {
opt(s)
}
return s
}
```
### Table-Driven Tests
```go
tests := []struct {
name string
input string
want string
wantErr bool
}{
{"valid", "hello", "HELLO", false},
{"empty", "", "", true},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
got, err := Process(tt.input)
if tt.wantErr {
require.Error(t, err)
return
}
require.NoError(t, err)
assert.Equal(t, tt.want, got)
})
}
```
## Go 1.25 Features
- **testing/synctest**: Deterministic concurrent testing with simulated clock
- **encoding/json/v2**: Experimental, 3-10x faster (GOEXPERIMENT=jsonv2)
- **runtime/trace.FlightRecorder**: Production trace capture on-demand
- **Container-aware GOMAXPROCS**: Auto-detects cgroup limits
- **GreenTea GC**: Experimental, lower latency (GOEXPERIMENT=greenteagc)
## References
- [PATTERNS.md](PATTERNS.md) - Detailed code patterns
- [TESTING.md](TESTING.md) - Testing strategies with testify/mockery
- [CLI.md](CLI.md) - CLI application patterns
## Tooling
```bash
go build ./... # Build
go test -race ./... # Test with race detector
golangci-lint run # Lint
mockery --all # Generate mocks
```
---
## Gotchas
- **`nil` channel sends/receives block forever; closed channel receives return zero value immediately** — `select` with a nil channel case disables that case, useful pattern but easy to do accidentally.
- **`defer` captures arguments at the call site, not at execution** — `defer fmt.Println(time.Now())` captures NOW, not the deferred time.
- **Pre-Go 1.22 for-loop variable capture closures over ONE variable across all iterations** — the goroutine-in-loop bug. Go 1.22 changed semantics; old habits create subtle bugs in mixed-version code.
- **`errors.Is` walks `Unwrap()` chains, BUT if a wrapped error implements `Is(target error) bool` itself, that custom Is wins over walking** — confusing when migrating from xerrors.
- **`sync.Pool` items can be GC'd between `Get` and the next `Put`** — never rely on a Pool to retain state.
© julianobarbosa · MIT · julianobarbosa/claude-code-skills