Skip to content
New

DeepSeek V4.1 Flash free for 7 days: 10M tokens a day after a top-up of $10 or more. Until Nov 30.

How it works
aeondave/golang-performanceReporting and compliance

golang-performance

⁨Go performance workflow: benchmark and profile (pprof/trace), identify hotspots, reduce allocations/GC and contention, and verify improvements with repeatable measurement. Use only after you have evidence the Go code is the bottleneck.⁩

v2026.11.13-21cd5683 installs+3 in 7 days39 StarsMITsynced 11 hours ago

Install

No NotHoly CLI yet? Install it first.

$ curl -fsSL https://notholy.com/install.sh | sh
$ notholy skills install aeondave/golang-performance

Writes to ⁦~/.notholy/skills⁩ after checking the signature and the SHA-256.

SignatureSigned, ed25519
S5VAd2xzJ6…zCywIqDg==The CLI checks the SHA-256 and the signature before it writes a file.
Package6cc84c1b…44f627ba
6cc84c1bb58f…733d44f627ba6 files · ⁦9.7 KB⁩
ScanMedium9 findings
  • Link to a raw IP addressreferences/compiler-and-runtime-tuning.md:103
  • Link to a raw IP addressreferences/profiling.md:43
  • Link to a raw IP addressreferences/profiling.md:55
See the full scan
Sourcegithub.com/AeonDave/malskill/tree/main/coding/golang-performance@21cd568

This skill is about measurement-first optimization in Go.

When to activate

Use this skill when you need to:

  • Confirm a performance regression (latency/throughput/CPU/memory)
  • Identify hot paths with pprof (CPU / heap / mutex / block)
  • Reduce allocations and GC pressure in a measured hotspot
  • Fix contention (mutex, scheduler, channel backpressure)
  • Validate improvements with benchmarks and repeatable runs

If you need general idioms and patterns (not measurement), use golang-patterns.


Rules of engagement

  • Profile before optimizing. A fast guess beats a slow change.
  • Change one thing at a time. Measure after each change.
  • Keep a baseline. Every claim should have “before vs after”.
  • Don’t optimize the cold path. Make the hot path boring.

Outcome expectations

  • Performance claims are backed by reproducible before/after measurements.
  • Profile type selection matches the observed symptom.
  • Optimizations are incremental, attributable, and regression-resistant.

Workflow

  1. Make it measurable

    • Add a benchmark (or a reproducible load test) for the suspected hotspot.
    • Run multiple iterations; record mean + variance.
  2. Capture evidence

    • CPU profile for time
    • Heap/allocs profile for memory
    • Mutex/block profiles for contention
    • Trace when the scheduler / GC behavior matters
  3. Analyze before changing code

    • Identify top offenders (top, top -cum)
    • Inspect annotated source (list)
    • Confirm whether you are bound by CPU, allocations, syscalls, or contention
  4. Apply targeted fixes

    • Allocation and GC: reduce allocations, reuse buffers, avoid retaining large backing arrays
    • Data layout: improve locality, avoid interface boxing in hot loops
    • Concurrency: reduce contention, bound goroutines, add backpressure
  5. Verify and document

    • Re-run the benchmark/profile
    • Ensure correctness isn’t traded away
    • Record the change and its measured impact

Symptom to first profile mapping

  • High CPU -> CPU profile
  • Memory growth -> heap profile (compare snapshots)
  • High allocation churn / GC pressure -> allocs profile
  • Latency spikes without CPU spike -> block profile
  • Lock contention suspicion -> mutex profile
  • Scheduler/pathological latency behavior -> runtime trace (flight recorder for rare events)
  • Growing goroutine count / suspected stuck workers -> goroutineleak profile, then the full goroutine profile
  • Shipped binary that is already profile-tuned and needs final runtime/build tuning -> compiler-and-runtime-tuning.md

Safety note: exposing pprof

net/http/pprof endpoints can leak sensitive runtime data. Prefer:

  • bind to localhost
  • protect with auth / firewall
  • enable only in dev / controlled environments

Resources

Load these references on demand:

  • references/profiling.md — pprof + trace (HTTP and go test capture) + goroutineleak + flight recorder
  • references/benchmarks.md — stable benchmarks, -benchmem, benchstat, hygiene
  • references/allocations-gc.md — allocation patterns, Green Tea GC, slice retention, sync.Pool
  • references/contention.md — mutex/block profiles, contention patterns, backpressure
  • references/compiler-and-runtime-tuning.md — load when code-level fixes have landed and you need PGO, GOGC/GOMEMLIMIT, GOMAXPROCS/cgroup, GC/cgo/thread knobs, or shipped-binary build flags

Files in this version

Permissions

PermissionDeclaredFound by the scan
Reads filesNoNo
Writes filesYesYes
Runs shell commandsYesYes
Uses the networkYesYes
Uses connectorsNoNo
Drives a browserNoNo

Scan findings

Reviewed on Nov 13, 2026

  1. MediumLink · Link to a raw IP addressreferences/compiler-and-runtime-tuning.md:103
  2. MediumLink · Link to a raw IP addressreferences/profiling.md:43
  3. MediumLink · Link to a raw IP addressreferences/profiling.md:55
  4. MediumLink · Link to a raw IP addressreferences/profiling.md:56
  5. MediumLink · Link to a raw IP addressreferences/profiling.md:74
  6. MediumLink · Link to a raw IP addressreferences/profiling.md:75
  7. MediumLink · Link to a raw IP addressreferences/profiling.md:94
  8. MediumLink · Link to a raw IP addressreferences/profiling.md:110
  9. InfoLink · Links to outside domains

A clean scan lowers the risk but does not prove a package is safe. Read what you install.

VersionPublishedCommitSHA-256SignaturePermission change
v2026.11.13-21cd568Nov 13, 202621cd5686cc84c1bSigned–

Ask anything your scope allows.

Create an account, add credits and ask the first question in the chat or the terminal.

  1. 1/3

    Create the account

    Individual or company. You can switch to a company later without losing balance or keys.

    IndividualCompany
  2. 2/3

    Add credits

    By card. Pay per token, no subscription.

    $5.00minimum deposit
  3. 3/3

    Ask

    In the chat, or install the CLI and run notholy login in your terminal.

    $ notholy login