Asdf go setup

Skill indradhanush/skills/plugins/asdf-go-setup/skills/asdf-go-setup

Install and configure gopls for a Go project that uses asdf to manage the Go version. Use this whenever gopls fails to start for a project, an editor reports "No version is set for command gopls", or a new Go project needs LSP set up with asdf. Accepts a project path as args; detects the correct Go version from .tool-versions or go.mod automatically.From its SKILL.md

Install

npx -y skills add indradhanush/skills --skill asdf-go-setup

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.9 KB, 747 tokens by cl100k_base, as published. Nobody here has run it

asdf Go Setup

Install gopls into the right location for a project's asdf-managed Go version.

Background

asdf's golang plugin only scans bin/ and go/bin/ inside an install (via list-bin-paths). gopls must live at:

$ASDF_DIR/installs/golang/<version>/bin/gopls

go install without an explicit GOBIN puts the binary in $GOPATH/bin (packages/bin/), which asdf never finds. The fix is to set both GOBIN and GOPATH explicitly.

Steps

1. Resolve the project path

Use args if provided; default to the current working directory.

2. Detect the Go version

Check in order, stopping at the first match:

<path>/.tool-versions — look for a line starting with golang
<path>/go.mod — read the go directive (e.g. go 1.22.12)
~/.tool-versions — global asdf fallback

If no version is found anywhere, report the gap and stop. Do not guess.

# From .tool-versions
grep '^golang ' <path>/.tool-versions | awk '{print $2}'

# From go.mod
grep '^go ' <path>/go.mod | awk '{print $2}'

3. Locate ASDF_DIR

echo "${ASDF_DIR:-$HOME/.asdf}"

4. Verify the version is installed

asdf list golang | grep -F "<version>"

If missing, tell the user to run asdf install golang <version> and stop.

5. Check whether gopls is already installed

ls "$ASDF_DIR/installs/golang/<version>/bin/gopls" 2>/dev/null

If the binary exists, skip to step 7.

6. Install gopls

Use the Go binary for that exact version so the module cache stays isolated:

GOBIN="$ASDF_DIR/installs/golang/<version>/bin" \
GOPATH="$ASDF_DIR/installs/golang/<version>/packages" \
  "$ASDF_DIR/installs/golang/<version>/go/bin/go" install \
  golang.org/x/tools/gopls@latest

Note: gopls >= v0.22 requires Go >= 1.26. If the project version is older, Go will auto-switch via GOTOOLCHAIN to a newer installed version. This is expected and harmless — the binary still lands in the project version's bin/ directory.

Then reshim:

asdf reshim golang <version>

7. Verify

Run this from inside the project path:

cd <path> && asdf which gopls

Expected output: $ASDF_DIR/installs/golang/<version>/bin/gopls

If it still fails, check that <path>/.tool-versions contains golang <version> — the shim uses that file to resolve which version to serve.

8. Report

Tell the user:

which Go version was detected and from which file
whether gopls was freshly installed or already present
the verified path returned by asdf which gopls

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.