Agent skill

Go Helper

by shepherdjerred in shepherdjerred/monorepo

Current Go development guidance for modules, toolchains, workspaces, testing, fuzzing, concurrency, profiling, security, and Go tooling.

GPL-3.0Auto-check passedSecurity

Install Go Helper

skills CLI
$ npx skills add shepherdjerred/monorepo --skill go-helper -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install shepherdjerred/monorepo go-helper --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/go-helper .claude/skills/go-helper && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
go-helper
GitHub stars
112
Token cost
~1.7k tokens
SKILL.md length
766 words
Files
5 (incl. references)
Skills in repo
63
Repo updated
First seen
Licence
GPL-3.0

At a glance

Current Go development guidance for modules, toolchains, workspaces, testing, fuzzing, concurrency, profiling, security, and Go tooling.

  • Performance work
  • SKILL.md covers Current baseline, Command authority, Focused verification and Modules and toolchains, plus 7 more sections
  • Calls go
  • Tasks that involve Fuzzing

What it does

Go Helper is an agent skill from shepherdjerred/monorepo. Current Go development guidance for modules, toolchains, workspaces, testing, fuzzing, concurrency, profiling, security, and Go tooling. Use when writing or reviewing Go, go.mod, go.work, Go CI, tests, performance work, or Go upgrades.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/modules-and-tooling.md`, `references/patterns-and-security.md` and `references/releases.md`).

It sits in Security, covering Fuzzing and Async programming. It works with Go. The repository describes itself as: Monorepo for all of my projects. The licence is GPL-3.0.

When your agent uses it

  • Performance work
  • Tasks that involve Fuzzing
  • Tasks that involve Async programming

Example prompts

  • “/go-helper”

What it can do on your machine

Read from SKILL.md and the folder at commit da14ae9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • go

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Go Helper loads about 1.7k tokens when it runs, and up to ~4.9k if it reads all its reference files. Until then it costs about 61 tokens; SKILL.md has 766 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from shepherdjerred/monorepo at commit da14ae9, republished under its GPL-3.0 licence (© shepherdjerred). 766 words, ~1,723 tokens.

Download SKILL.mdSave it as .claude/skills/go-helper/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
go-helper
description
Current Go development guidance for modules, toolchains, workspaces, testing, fuzzing, concurrency, profiling, security, and Go tooling. Use when writing or reviewing Go, go.mod, go.work, Go CI, tests, performance work, or Go upgrades.

Go Helper

Use the module's declared Go language version, propagate errors, keep goroutine ownership explicit, and run the repository's real verification commands. Distinguish read-only module checks from operations that edit files or fetch dependencies.

Current baseline

Verified 2026-08-03: current stable is Go 1.26.5.

bash
go version
go env GOTOOLCHAIN GOVERSION

Go 1.26 added expression-valued new, the default Green Tea garbage collector, lower cgo overhead, crypto/hpke, and other library/tool changes. JSON v2 remains experimental behind GOEXPERIMENT=jsonv2; SIMD work is experimental and platform-specific.

The go directive is a strict minimum language/toolchain version. toolchain suggests a toolchain for the main module. Module-version boundaries also control behavior such as Go 1.22 loop variables and Go 1.23 timer channels.

Read references/releases.md for the 44-page research ledger. Read references/modules-and-tooling.md for module, workspace, toolchain, lint, and dependency operations. Read references/testing-and-performance.md for tests, fuzzing, races, synctest, traces, profiles, and PGO. Read references/patterns-and-security.md for errors, goroutines, HTTP, paths, logging, randomness, and vulnerability checks.

Command authority

Read-only or check-oriented commands:

bash
go version
go env
go list ./...
go test ./...
go test -race ./...
go vet ./...
go mod verify
go mod tidy -diff
go work edit -json

go mod tidy edits go.mod and go.sum. Dependency and download commands can mutate caches and involve network state. Review their effect instead of labeling them read-only.

Focused verification

Use the package's actual task when one exists. A generic Go project baseline is:

bash
go test ./...
go test -race ./...
go vet ./...
go mod tidy -diff

Run the repository-pinned golangci-lint command if configured. Do not prescribe a fixed number of linters; its catalog and defaults are versioned.

Modules and toolchains

go.mod
module example.com/project

go 1.26

The go line is the minimum required version and selects language behavior. GOTOOLCHAIN controls whether the bundled, PATH, or downloadable toolchain is selected.

Use go get for dependency changes and go mod tidy to reconcile the module graph. Review both go.mod and go.sum. Avoid a broad go get -u ./...; upgrade an intentional set, read release notes, and verify the resulting graph.

For a non-mutating tidy check:

bash
go mod tidy -diff

Errors

Return errors with context and preserve identity with %w when callers may inspect them:

go
func load(path string) ([]byte, error) {
	data, err := os.ReadFile(path)
	if err != nil {
		return nil, fmt.Errorf("read %q: %w", path, err)
	}
	return data, nil
}

Do not discard Close, ReadAll, Write, trace, or server errors when failure can affect correctness. For cleanup whose error matters, call and return it explicitly rather than relying only on defer.

Goroutine ownership

Every goroutine needs a lifecycle: completion, cancellation, or a process-long owner. Thread context.Context through request-scoped operations; never store it in a long-lived struct solely for convenience.

Prefer errgroup or an equivalent structured owner when sibling failure should cancel work. Bound concurrency and preserve output ordering when the contract requires it.

Tests and benchmarks

Go 1.25 stabilized testing/synctest; the stable API is synctest.Test(t, func(t *testing.T) { ... }) plus synctest.Wait(). Fake time advances only when goroutines in the bubble are durably blocked.

Use B.Loop() for current benchmarks. Avoid exact universal race-detector or benchmark overhead claims. The race detector only finds races executed on a supported platform.

Fuzz failures are stored at testdata/fuzz/FuzzName/<hash>. Keep them as regression corpus entries.

Show full SKILL.md (319 more words)Show less

Modern APIs

  • Iterator functions and iter.Seq / Seq2 support range-over-function patterns. Do not yield after yield returns false.
  • maps and slices expose iterator-producing and consuming helpers.
  • unique.Make canonicalizes comparable values into handles.
  • math/rand/v2 is non-cryptographic randomness.
  • os.Root confines supported file operations against symlink path escapes.
  • runtime/trace.FlightRecorder provides bounded recent trace data; check Start and WriteTo errors and call Stop.
  • crypto/hpke implements the RFC 9180 DHKEM suites. Hybrid post-quantum KEMs require a separate specification; use protocol-specific expertise before designing cryptography.

HTTP and profiling

Check every server error. Bind diagnostic endpoints to an operator-only interface and never expose net/http/pprof unauthenticated to the public network.

Block and mutex profiles require nonzero profiling rates. CPU, heap, goroutine, block, and mutex profiles answer different questions.

Representative production CPU profiles can drive PGO through default.pgo. A profile must match the workload; do not treat PGO as a universal speed switch.

Security

  • Use crypto/rand for secrets; math/rand/v2 is for non-security randomness.
  • Use os.Root or equivalent confinement for untrusted relative paths.
  • Keep private module configuration in GOPRIVATE, GONOPROXY, and GONOSUMDB as appropriate. GONOSUMCHECK does not exist.
  • In source mode, run govulncheck for known vulnerabilities reachable from application call paths. Binary mode reports vulnerable symbols but does not reconstruct those call paths.
  • Treat imported pprof handlers, cgo, templates, archive extraction, and subprocess arguments as security boundaries.
  • Use structured log/slog fields and never log secrets.

Review checklist

  • Verify Go stable, the module go line, and selected toolchain.
  • Use go mod tidy -diff for a non-writing module check.
  • Review intentional dependency changes and both module files.
  • Propagate meaningful errors, including cleanup and server failures.
  • Give every goroutine an owner and cancellation path.
  • Use exact tests, current synctest, correct fuzz corpus paths, and workload-qualified performance claims.
  • Keep profiling endpoints private and check trace/profile errors.
  • Use current golangci-lint v2 configuration and canonical gopls setting names.
  • Separate experimental JSON v2 and SIMD behavior from stable defaults.
  • Run govulncheck and use cryptographic randomness for secrets.

© shepherdjerred, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in packages/dotfiles/dot_agents/skills/go-helper of shepherdjerred/monorepo.

  • SKILL.md
  • references/modules-and-tooling.md
  • references/patterns-and-security.md
  • references/releases.md
  • references/testing-and-performance.md

Open the folder on GitHubat commit da14ae9

Compare with similar skills

Go Helper next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Go Helper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Go Helper this skillshepherdjerred/monorepo112—~1.7kAutomated safety check: PassGPL-3.0
Golang Testingunxed/f42411 repos~4.5kAutomated safety check: PassMIT
Testing Goericrisco/rsc-harness167—~3.7kAutomated safety check: PassMIT
Concurrency Fuzzing Testingdzhalaevd/Donatello135—~3.3kAutomated safety check: PassApache-2.0
Golang Patternsantoniopaya22/go-rest-template1729 repos~3.5kAutomated safety check: PassNone
Golang Proantoniopaya22/go-rest-template1723 repos~1.2kAutomated safety check: PassMIT

Similar skills

  • Production-ready Golang tests — table-driven tests, testify suites and mocks, parallel tests, fuzzing, fixtures, goroutine leak detection with goleak, snapshot testing, code coverage, integration…

    241 GitHub starsUsed in 1 repo~4.5k tokens
    Testing & QAAuto-check passed
  • Testing Go

    ericrisco/rsc-harness

    A skill your agent uses when writing or running Go tests — table-driven cases, named subtests, parallel isolation, fakes instead of mock frameworks, coverage profiles, benchmarks, fuzzing, golden…

    167 GitHub stars~3.7k tokensUpdated yesterday
    SecurityAuto-check passed
  • Concurrency Fuzzing Testing

    dzhalaevd/Donatello

    Use as the lead skill when Python tests must expose scheduler/interleaving bugs in asyncio, threading, queues, workers, databases, caches, or mixed-concurrency code

    135 GitHub stars~3.3k tokensUpdated 5 days ago
    SecurityAuto-check passed
  • Golang Patterns

    antoniopaya22/go-rest-template

    Idiomatic Go patterns, best practices, and conventions for building robust, efficient, and maintainable Go applications.

    172 GitHub starsUsed in 9 repos~3.5k tokens
    DevelopmentAuto-check passed
  • Golang Pro

    antoniopaya22/go-rest-template

    Implements concurrent Go patterns using goroutines and channels, designs and builds microservices with gRPC or REST, optimizes Go application performance with pprof, and enforces idiomatic Go with…

    172 GitHub starsUsed in 3 repos~1.2k tokens
    Backend & APIsAuto-check passed
  • Official

    Covers handling Go's context.Context idiomatically in fp-go code: reading and scoping context through operators, timeouts, cancellation and converting ctx-first functions.

    2k GitHub stars~4.2k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from shepherdjerred/monorepo

All 63 skills in this repo
  • Bun Runtime Best Practices

    shepherdjerred/monorepo

    Bun runtime APIs and current operational patterns for files, processes, modules, networking, databases, tests, and deployment.

    112 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Bun Test Patterns

    shepherdjerred/monorepo

    Current Bun test runner guidance for discovery, isolation, parallelism, sharding, changed tests, mocks, timers, snapshots, coverage, DOM Testing Library, and integration teardown.

    112 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Bun Workspaces

    shepherdjerred/monorepo

    Current Bun workspace guidance for isolated and hoisted linkers, catalogs, filters, scripts, dependency classes, lockfiles, lifecycle trust, caches, publishing, TypeScript package exports, and…

    112 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Deep Research

    shepherdjerred/monorepo

    This skill should be used when the user asks to "deep research", "research this topic", "investigate thoroughly", "do a deep dive on", "comprehensive research on", "find everything about", "survey…

    112 GitHub stars~4.7k tokensUpdated today
    Auto-check: notes
  • Figma Use

    shepherdjerred/monorepo

    This skill should be used when the user asks to "create a Figma design", "design in Figma", "make a Figma mockup", "create an app icon", "design UI", "render JSX to Figma", "export from Figma"…

    112 GitHub stars~946 tokensUpdated today
    Auto-check passed
  • Fish Helper

    shepherdjerred/monorepo

    Current Fish shell scripting, functions, abbreviations, completions, variables, events, configuration, plugins, testing, and safety guidance.

    112 GitHub stars~2k tokensUpdated today
    Auto-check passed

Works with

Questions about Go Helper

What does Go Helper do?

Current Go development guidance for modules, toolchains, workspaces, testing, fuzzing, concurrency, profiling, security, and Go tooling. Go Helper is an agent skill from shepherdjerred/monorepo. Current Go development guidance for modules, toolchains, workspaces, testing, fuzzing, concurrency, profiling, security, and Go tooling.

When should I use Go Helper?

Go Helper fits situations like: performance work; tasks that involve Fuzzing; tasks that involve Async programming.

How do I install Go Helper in Claude Code?

Run `npx skills add shepherdjerred/monorepo --skill go-helper -a claude-code`. Or copy the skill folder (packages/dotfiles/dot_agents/skills/go-helper in shepherdjerred/monorepo) into .claude/skills/go-helper in your project. Claude Code loads it when a task matches its description.

How do I install Go Helper in Codex?

Run `npx skills add shepherdjerred/monorepo --skill go-helper -a codex`. Or copy the skill folder (packages/dotfiles/dot_agents/skills/go-helper in shepherdjerred/monorepo) into .agents/skills/go-helper in your project. Codex loads it when a task matches its description.

Can I use Go Helper in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add shepherdjerred/monorepo --skill go-helper -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/go-helper, .gemini/skills/go-helper, .github/skills/go-helper and .opencode/skills/go-helper in your project.

What does Go Helper need to run?

Going by SKILL.md and its folder, Go Helper needs the command-line tools its instructions call (go).

Does Go Helper access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Go Helper safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Go Helper use?

Go Helper is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Go Helper use?

About 1.7k tokens (SKILL.md is roughly 6.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.1k tokens, read only when the agent opens those files.

What are the alternatives to Go Helper?

Skills that share tags, products or a category with Go Helper: Golang Testing (unxed/f4, 241 stars), Testing Go (ericrisco/rsc-harness, 167 stars), Concurrency Fuzzing Testing (dzhalaevd/Donatello, 135 stars) and Golang Patterns (antoniopaya22/go-rest-template, 172 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Go Helper?

shepherdjerred (a GitHub user) maintains it in shepherdjerred/monorepo, which has 112 GitHub stars. The repository holds 63 skills in this directory. The repository was last updated on October 8, 2026.

Source: shepherdjerred/monorepo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.