golang-data-structures

The `golang-data-structures` skill provides a comprehensive understanding of Go's built-in and standard library data structures, including slices, maps, arrays, and specialized collections such as lists, heaps, and rings. It focuses on the internal mechanics of these structures, helping developers reason about memory layout, allocation costs, access patterns, and correct usage. This skill addresses common pitfalls in Go programming, such as slice and map aliasing, preallocation, and copy semantics, enabling developers to write more efficient and robust code.

Key features of this skill include detailed insights into slice and map internals, growth strategies, preallocation techniques, and use of the `slices` package introduced in Go 1.21. It provides guidance on when to prefer arrays over slices, best practices for using standard library containers like `container/heap`, `container/list`, and `container/ring`, and the proper use of `strings.Builder` versus `bytes.Buffer`. Additionally, it covers generic collections with appropriate constraints, safe usage of `unsafe.Pointer`, and use of `weak.Pointer` for cache or canonicalization purposes in Go 1.24+.

This skill is intended for Go developers, software engineers, and coding agents who need to optimize data structure usage in their applications. It is particularly valuable for those implementing generic containers, working with unsafe or weak pointers, or aiming to understand the performance characteristics of slices and maps. The skill is compatible with Claude Code and similar AI coding agents, making it useful both for human programmers seeking guidance and AI systems assisting in Go development projects.