go-interface-design agent skill by eduardo-sl

At a glance

Before you install

Read from the skill's files at the directory's October 19, 2026 snapshot: what ships with it, what its code reads, and the terms it is published under.

• Bundled scripts: none.
• Tool permissions requested: Read Edit Write Glob Grep Bash(go:*) Bash(gofmt:*) (the allowed-tools field of SKILL.md).
• License: MIT, an open-source or open-content license.

Install go-interface-design

The skills CLI works with Claude Code, Codex, Cursor and other agents; the other routes copy the folder by hand.

npx skills add 'https://github.com/eduardo-sl/go-agent-skills/tree/main/skills/(architecture)/go-interface-design'

tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/eduardo-sl/go-agent-skills.git "$tmp/repo"
mkdir -p .claude/skills
cp -R "$tmp/repo/"'skills/(architecture)/go-interface-design' .claude/skills/
rm -rf "$tmp"

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
    --repo eduardo-sl/go-agent-skills \
    --path 'skills/(architecture)/go-interface-design'

eduardo-sl/go-agent-skills is third-party code. Read SKILL.md and any bundled scripts before you install it.

How the author describes it

Go interface design patterns: implicit interfaces, consumer-side definition, interface compliance verification, composition, the accept-interfaces-return-structs principle, and common pitfalls. Use when designing interfaces, decoupling packages, defining contracts, reviewing interface usage, or refactoring for testability. Trigger examples: "design interface", "accept interfaces return structs", "interface compliance", "consumer-side interface", "interface composition". Not for: HTTP handler patterns (go-api-design), general review (go-code-review).

From the description field of SKILL.md. Agents read this line to decide when to load the skill.

Compatibility, from SKILL.md

Sections in SKILL.md

• 1. The Cardinal Rule: Define Interfaces at the Consumer
• 2. Keep Interfaces Small
• 3. Accept Interfaces, Return Structs
• 4. Verify Interface Compliance at Compile Time
• 5. Don't Use Pointers to Interfaces
• 6. The Empty Interface
• 7. Optional Configuration Is Not an Interface Problem
• 8. Common Interface Anti-Patterns
• Premature interfaces:
• Interface pollution:
• Sealed interfaces vs enums:
• 9. Embedding and Type Assertions
• Decision Checklist

Files in the skill folder

• SKILL.md
• references/embedding-and-assertions.md

Suede Skill Check: 95/100 · A

go-interface-design passes the required frontmatter check and all seven graded checks, which cover the SKILL.md format, a declared license and a commit in the last year. Those checks earn 56 of the score’s points; the rest come from description quality, instruction depth, bundled files, maintenance and curated-list citations. How the score works.

Where this skill is cited

eduardo-sl/go-agent-skills appears in 3 curated lists: BehiSecc/awesome-claude-skills, VoltAgent/awesome-agent-skills, heilcheng/awesome-agent-skills.

More developer tools skills

All developer tools and frameworks skills

More from eduardo-sl/go-agent-skills

All 31 skills in eduardo-sl/go-agent-skills