gotest skill
A skill teaching agents to write Go tests with the gotest framework: lifecycle hooks, parallelism and the CLI via go tool.
- 129 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The skill changes project test files, and the CLI may raise the go line in go.mod on upgrade.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/gotestDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skill changes project test files, and the CLI may raise the go line in go.mod on upgrade.
This is third-party code. Review the repository files before installing.
What it does
The `writing-gotest-tests` skill guides an agent while writing, fixing and reviewing tests in a Go repository that uses gotest. It restates the framework rules: lifecycle hooks instead of `defer`, polling instead of `time.Sleep`, the parallel recipe, `When` labels that state only a condition, and differences between releases. Reference files cover topics separately: assertions, fixtures, fuzzing, CI and reporting. The gotest core itself describes test suites as Go structs and generates the wiring, `t.Run` nesting and process isolation. The skill installs with `go tool gotest skill install`, which uses the version pinned in `go.mod`, or as a plugin from the repository.
Who it is for. Go developers writing gotest tests together with Claude Code, Codex or Cursor.
Good fit when
- An agent adds a test suite to a Go module that uses gotest.
- Old testify tests are migrated to gotest.
- Tests must run in parallel with process isolation.
- You need to check code against the rules of a specific framework version before upgrading.
Not a fit when
- The project writes tests with plain `go test` and no gotest.
- You use another language; the framework and skill are Go only.
- The agent must not update project dependencies.
Example request
Write a gotest suite for the user service: a `BeforeEach` hook, a duplicate email case and a parallel run.Limitations
The skill is useful only in modules that use gotest and is useless elsewhere. Framework versions differ, so the agent first checks the version pinned in `go.mod`. Upgrading to `@latest` can raise the `go` line of the module, and the skill warns against blind upgrades. A plugin installs the newest skill from the main branch rather than the one matching your pin. Go 1.26 or newer is required. The framework has no third-party runtime dependencies.
How to disable. Delete the `writing-gotest-tests` skill directory from `.agents/skills` or `.claude/skills`, and remove the plugin with your agent command. The framework itself is dropped from `go.mod` separately.
FAQ
How do I install the skill for Claude Code?
Run `go tool gotest skill install --dir=.claude/skills`, or `/plugin marketplace add mvrahden/go-test` and `/plugin install gotest@go-test`.
And for Codex and Cursor?
`go tool gotest skill install` with no flags writes the skill to `.agents/skills`, read by Codex, Cursor, Gemini CLI and Copilot. A Codex plugin exists too.
Which skill version gets installed?
The CLI command takes the version pinned by your `go.mod`. The plugin installs the newest one from the main branch.
What does gotest itself need?
Go 1.26 or newer and `go get -tool github.com/mvrahden/go-test/cmd/gotest@latest`. It runs as `go tool gotest ./...`.
What can an agent see without the source?
`gotest spec --static ./...` prints what a package promises before running, and `gotest discover ./...` gives the same tree as JSON.
Discussion
No questions or reviews yet.
Related
SkillsA plugin that teaches agents to write Hegel property-based tests for six languages and review them for weak spots
A skill that reads a repository once and installs checks: code rules become gates that fail a commit or a CI run.
Paul Hudson's Swift Testing skill: parameterized tests, confirmations, exit tests and a move from XCTest to the new framework
Skill and Go load tester that runs HTTP, database and Redis load on one clock and reports where the slowdown starts
57 reference files on Playwright tests in TypeScript: the agent pulls the one that fits the task, from locators to CI sharding
An adversarial code-audit skill: Hunter finds bugs, Skeptic challenges them, Referee rules, and no source edit happens without your permission
README in short
The README section "Coding Agents" lists installation for Claude Code, Codex, Copilot CLI and any agent via `npx skills add`. The skill version at review time was 1.36.