ReddRadar
Agent skill
interface-embedding
Compose interfaces through embedding for flexible contracts
Install this agent skill to your Project
npx add-skill https://github.com/JamesPrial/claudefiles/tree/main/skills/golang/interfaces/embedding
SKILL.md
Interface Embedding Patterns
Go interfaces can embed other interfaces to create larger contracts. Use this for composition, not inheritance.
Basic Embedding
CORRECT - Compose small interfaces
type Reader interface {
Read(p []byte) (n int, err error)
}
type Closer interface {
Close() error
}
type ReadCloser interface {
Reader
Closer
}
// Any type implementing both Reader and Closer satisfies ReadCloser
WRONG - Giant interface instead of composition
type FileHandler interface {
Read(p []byte) (n int, err error)
Write(p []byte) (n int, err error)
Close() error
Seek(offset int64, whence int) (int64, error)
// Kitchen sink approach
}
Practical Patterns
Progressive enhancement:
type BasicCache interface {
Get(key string) ([]byte, error)
Set(key string, val []byte) error
}
type ExpiringCache interface {
BasicCache
SetWithTTL(key string, val []byte, ttl time.Duration) error
}
func UseCache(c BasicCache) { /* Works with any cache */ }
func UseAdvanced(c ExpiringCache) { /* Needs TTL support */ }
Optional behavior detection:
type Processor interface {
Process(data []byte) error
}
type BatchProcessor interface {
Processor
ProcessBatch(items [][]byte) error
}
func Handle(p Processor, items [][]byte) error {
if bp, ok := p.(BatchProcessor); ok {
return bp.ProcessBatch(items) // Use batch if available
}
// Fallback to individual processing
for _, item := range items {
if err := p.Process(item); err != nil {
return err
}
}
return nil
}
Guidelines
- Embed to compose small, focused interfaces
- Keep embedded interfaces from stdlib or well-known packages
- Use type assertions to detect optional capabilities
- Avoid deep embedding hierarchies (2-3 levels max)
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
JamesPrial/claudefiles
plugin-packager
Package claudefiles components into a valid Claude Code plugin
JamesPrial/claudefiles
plugin-packager-validation
Plugin validation errors and fixes
JamesPrial/claudefiles
plugin-packager-subset
Package language-specific subsets of claudefiles
JamesPrial/claudefiles
plugin-packager-hooks
Handle hook scripts and paths for plugin packaging
JamesPrial/claudefiles
go-concurrency
Go concurrency patterns. Routes to specific patterns.
JamesPrial/claudefiles
go-sync-primitives
sync.WaitGroup and sync.Mutex patterns
Didn't find tool you were looking for?