Go Context

What it does

This skill, go-context, provides guidance on how to properly utilize Go’s context.Context type within your AI agent's code. It enforces best practices for managing context flow, ensuring consistency and clarity in Go applications. The skill focuses on how functions should accept a context.Context as their first parameter, avoiding storage of contexts within structs, and using standard context.Context types rather than custom implementations.

When to use it

• When developing Go code for your AI agent that requires request-scoped data like authentication information or trace IDs.
• To ensure adherence to established Go conventions regarding context management.
• When refactoring existing Go code to improve clarity and maintainability by correctly handling contexts.
• If you need a reminder of the preferred methods for passing application data within your agent's Go codebase.

Key capabilities

• Enforces the convention of accepting context.Context as the first parameter in functions.
• Discourages storing context.Context within struct types, advocating for explicit parameter passing.
• Prohibits the creation of custom context types and promotes using the standard context.Context.
• Provides guidance on where to store application data (function parameters, receiver, globals, or context values).

Example prompts

• "How should I pass a deadline to this Go function?"
• "What's the best way to manage request IDs in my Go agent?"
• "Remind me of the rules for using context.Context in Go."

Tips & gotchas

• This skill is specifically tailored for Go development and won’t be applicable to other programming languages.
• While context values are useful for request-scoped data, avoid using them for optional function parameters or configuration that doesn't vary per request.
• Be mindful of interfaces requiring specific method signatures when deciding whether to adhere strictly to the "no Context in structs" rule.