go-interface-design

What problem does it solve?

This Skill helps Go developers avoid common interface design mistakes by teaching consumer-side interface definition, small and composable interfaces, and compile-time compliance checks so code remains decoupled, testable, and idiomatic.

Core Features & Use Cases

• Consumer-side interfaces: Explain why interfaces should be declared where they are consumed to avoid import cycles and bloated abstractions.
• Small, composable interfaces: Recommend 1–3 method interfaces and composition patterns to keep abstractions focused.
• Practical rules: Guidance on accepting interfaces and returning concrete types, verifying implementation at compile time, avoiding pointers to interfaces, and replacing empty interface usage with generics or narrower types.
• Use Cases: Package API design, code reviews, refactors for testability, and creating stable testing seams.

Quick Start

Describe the consumer's needs and ask the agent to design a minimal interface for that consumer, include a recommendation to verify compile-time compliance and explain why the interface belongs to the consumer.