← All skills

design-an-interface

100 / 100 · Low risk

Fine to try.

By open-gsd/gsd-pi (GitHub) · design · 1,366 stars · scanned at commit c0bc9c4

Produce 3+ radically different designs for a module, API, or interface, compare them in prose, and synthesize a recommendation. Use when asked to "design an interface", "shape this API", "design it twice", "explore module boundaries", or when planning a new deep module and the first idea is unlikely to be the best. Based on "Design It Twice" from A Philosophy of Software Design — the value is the contrast, not the first draft.

Works with any agent that supports SKILL.md skills.

What this skill can do

We found nothing in the files we read that matches our rules. That does not prove the skill is safe: see the limits of static scanning.

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'design-an-interface' ] || [ -L ~/.agents/skills/'design-an-interface' ]; then echo 'A skill folder named design-an-interface already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/open-gsd/gsd-pi' "$d" && git -C "$d" checkout --quiet 'c0bc9c4e7e0a8581aeac3af397031dc3a63d012e' -- 'src/resources/skills/design-an-interface' && mkdir -p ~/.agents/skills && cp -R "$d"/'src/resources/skills/design-an-interface' ~/.agents/skills/'design-an-interface' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'design-an-interface' ~/.claude/skills/'design-an-interface' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for open-gsd/gsd-pi shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/open-gsd/gsd-pi.svg)](https://zalavijaysinh.github.io/skilltrust/repos/open-gsd/gsd-pi/)

Score history