К основному содержанию
скилл CX Codex

writing-go — скилл для Claude Code: идиоматичный Go 1.25+

Скилл writing-go задаёт агенту правила написания Go: стандартная библиотека вместо зависимостей, конкретные типы, ошибки с контекстом, табличные тесты.

MIT 110 установок ★ 17 обновлён 2026-10-14

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add julianobarbosa/claude-code-skills --skill writing-go -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/writing-go/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/writing-go/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Языки программирования» →
golang-stretchr-testify samber Скилл golang-stretchr-testify направляет агента при написании тестов на Go с библиотекой stretchr/testify. Помогает разделять assert и require, строить моки и запускать тестовые сьюты. CX Codex +1 41 600установок golang-grpc samber Скилл golang-grpc для Claude Code задаёт практики работы с gRPC в Go: от .proto и серверов до ошибок, TLS, тестов и потоковых RPC. Охватывает разработку и ревью gRPC-сервисов. CX Codex +1 41 400установок code-simplifier rtk-ai Скилл code-simplifier находит избыточные конструкции и лишние аллокации в коде на Rust для RTK. Упрощает синтаксис по идиомам языка, не ломая поведение проекта. CX Codex +1 2 300установок golang-pro https://github.com/Jeffallan Скилл golang-pro для ИИ-агента, который пишет идиоматичный Go: горутины, каналы, gRPC, профилирование через pprof и табличные тесты. CX Codex +1 19 800установок go-interfaces cxuu Скилл go-interfaces направляет агента при проектировании интерфейсов в Go, композиции типов и проверке контрактов. Помогает избежать преждевременных абстракций в публичном API. CX Codex +1 1 400установок go Mindrally Задаёт агенту правила идиоматичного Go: слоистая архитектура, работа с net/http, горутины, табличные тесты. CX Codex +1 804установок

Из того же набора37

Весь набор →
context7 Скилл ищет документацию и примеры кода для конкретной версии библиотеки через Context7. Пригодится перед написанием кода по API, в котором вы не уверены. CX Codex +1 114установок git-worktree Управляет параллельными рабочими деревьями git worktree с созданием окон tmux и вкладок iTerm2. Помогает работать над ветками без stash. CX Codex +1 111установок writing-typescript Скилл writing-typescript задаёт идиоматичный стиль TypeScript для сервисов Node.js, React-приложений и обсуждения TS-паттернов. Поддерживает строгую типизацию и современный toolchain. CX Codex +1 111установок az-aks-agent Скилл az-aks-agent для Claude Code разбирает состояние и настройки кластера Azure Kubernetes Service по запросам на обычном языке. Ищет проблемы с подами, сетью, хранилищем и RBAC. CX Codex +1 110установок macos-cleaner Скилл macos-cleaner анализирует, чем занято место на Mac, и предлагает варианты очистки. Он пригодится, когда нужно найти крупные файлы и оценить последствия удаления. CX Codex +1 109установок knative Скилл knative помогает развёртывать serverless-сервисы в Kubernetes, настраивать автомасштабирование до нуля и маршрутизировать события CloudEvents. CX Codex +1 109установок pyroscope Инструкции и шаблоны для непрерывного профилирования с Grafana Pyroscope: развёртывание в Kubernetes, настройка SDK для Go, Java, Python и подключение хранилищ S3 или GCS. CX Codex +1 108установок using-cloud-cli Скилл using-cloud-cli для Claude Code задаёт правила работы с bq, gcloud и aws. Описывает запросы BigQuery, облачные CLI-команды и решения по сервисам AWS и GCP. CX Codex +1 108установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой