# Go

> Conventions and commands for Go projects — testing, linting, JSON Schema generation, and error handling. Use when developing, testing, or linting Go code in this repository.

- Skill: `suzuki-shunsuke/go` (Agent Skill)
- Install (CLI): `npx skillmds@latest add suzuki-shunsuke/go`
- Raw SKILL.md: https://api.skillmd.com/api/skills/suzuki-shunsuke/go/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: suzuki-shunsuke (https://skillmd.com/u/suzuki-shunsuke)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/suzuki-shunsuke/go

---


Test:

```sh
go test ./... -race -covermode=atomic
```

Lint:

```sh
go vet ./...
golangci-lint run
```

Auto fix lint errors:

Note that only a few errors can be fixed by this command.
Many lint errors needs to be fixed manually.

```sh
golangci-lint fmt
```

## JSON Schema

If `cmd/gen-jsonschema` is present, JSON Schema for the application can be updated by the following command:

```sh
go run ./cmd/gen-jsonschema
```

## Test Framework Guidelines

- **DO NOT** use `testify` for writing tests
- **DO** use `google/go-cmp` for comparing expected and actual values

## File Naming Conventions

- Internal test files: append `_internal_test.go` for internal testing

## Error Handling

Use slog and [slog-error](https://github.com/suzuki-shunsuke/slog-error).