Back to Skills

go-local-health

Run local Go health checks (tests, coverage, lint) in Go repositories that contain go.mod/go.sum. Use when the user asks to run or interpret local Go test/coverage/lint workflows using tools like lazygotest, gocovsh, tparse, and golangci-lint. Do not use for Rust or non-Go projects.

43stars5forksUpdated 4/3/2026

Security Assessment

Safe(100/100)
Security Score100/100

About go-local-health

The Go Local Health skill provides a structured and reliable workflow for running local Go tests, coverage checks, and linting in repositories that contain a `go.mod` file. It addresses the challenge of ensuring consistent code quality and test coverage without manually configuring or deriving commands. By verifying the presence of Go module files and respecting the repository's toolchain configuration, this skill minimizes errors that can arise from misaligned environments and missing tools, enabling developers to focus on coding rather than setup.

FAQ

Which repositories can I use this skill with?

This skill is designed exclusively for Go repositories containing a `go.mod` file. It will not run in non-Go projects or in repositories lacking module definitions.

What tools does this skill require?

The skill relies on Go tools such as `go`, `tparse`, `golangci-lint`, `lazygotest`, and `gocovsh`. Required tools depend on the workflow: Quick Snapshot, Interactive Test Loop, or Coverage Explorer. If a tool is missing, the skill will prompt for installation rather than using substitutes.

Can I use this skill for interactive test sessions?

Yes. The Interactive Test Loop mode uses `lazygotest` to allow developers to filter packages and rerun tests while actively editing code. This mode launches a UI and is meant for iterative development.

How does the skill handle coverage reporting?

Coverage Explorer mode leverages `gocovsh` to inspect coverage hotspots in detail. A coverage profile (`cover.out`) can be generated with `go test -coverprofile=cover.out ./...` prior to launching the explorer. The skill summarizes gaps and highlights the worst-performing packages.

Does this skill modify code or CI configurations?

No. The skill does not alter code or CI configurations unless explicitly requested by the user. Its focus is strictly on running local health checks and reporting results.

Install go-local-health

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill