What is chao-go-perf?

Chao Go Perf is a skill file made for AI coding agents, specifically ones that work inside Claude Code. It packages together the kind of advice a Go performance expert would give, drawn from Dave Cheney's high performance Go workshop, the go-perfbook by dgryski, Effective Go, and the Go 101 Optimizations guide. The skill covers diagnosing bottlenecks: reading CPU profiles and flame graphs, finding memory allocation hot spots through escape analysis, watching garbage collector pressure with GODEBUG and GOMEMLIMIT settings, detecting lock contention with mutex profiles, and checking how well code scales across goroutines with the race detector and trace tool. It also covers memory optimization techniques such as escape analysis flags, pre allocating slices and maps, using strings.Builder instead of repeated string concatenation, reusing objects with sync.Pool, and rearranging struct fields to reduce padding. On the compiler side it explains bounds check elimination, inlining decisions, and how to visualize what the compiler is doing with GOSSAFUNC. Other sections cover CPU cache behavior, including false sharing and data layout choices between array of structs and structure of arrays, plus branch prediction friendly code. For concurrency, it walks through choosing between Mutex, RWMutex, atomic operations, and sync.Map, along with sharded locks and channel versus mutex tradeoffs. To use it, a person clones the repository into their Claude Code skills folder or installs it with a package command, then either lets it trigger automatically during a conversation about Go performance topics or calls it directly. It is meant for developers already writing Go who want expert level guidance on making their programs faster, not for beginners learning the language for the first time. The project is released under the MIT license.