Design an Interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

5 stars 2 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add GAGAA-HUE/ASHUO-claude-skills --skill design-an-interface
Manual install
git clone --depth 1 https://github.com/GAGAA-HUE/ASHUO-claude-skills.git /tmp/ASHUO-claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/ASHUO-claude-skills/design-an-interface ~/.claude/skills/design-an-interface

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Design an Interface

Based on "Design It Twice" from "A Philosophy of Software Design": your first idea is unlikely to be the best. Generate multiple radically different designs, then compare.

## Workflow

### 1. Gather Requirements

Before designing, understand:

- [ ] What problem does this module solve?
- [ ] Who are the callers? (other modules, external users, tests)
- [ ] What are the key operations?
- [ ] Any constraints? (performance, compatibility, existing patterns)
- [ ] What should be hidden inside vs exposed?

Ask: "What does this module need to do? Who will use it?"

### 2. Generate Designs (Parallel Sub-Agents)

Spawn 3+ sub-agents simultaneously using Task tool. Each must produce a **radically different** approach.

```
Prompt template for each sub-agent:

Design an interface for: [module description]

Requirements: [gathered requirements]

Constraints for this design: [assign a different constraint to each agent]
- Agent 1: "Minimize method count - aim for 1-3 methods max"
- Agent 2: "Maximize flexibility - support many use cases"
- Agent 3: "Optimize for the most common case"
- Agent 4: "Take inspiration from [specific paradigm/library]"

Output format:
1. Interface signature (types/methods)
2. Usage example (how caller uses it)
3. What this design hides internally
4. Trade-offs of this approach
```

### 3. Present Designs

Show each design with:

1. **Interface signature** - types, methods, params
Read the full skill on GitHub

Details

Skill name
design-an-interface
Path
design-an-interface/SKILL.md
Repo updated
3 November 2026

FAQ

What does the Design an Interface skill do?

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

How do I install the Design an Interface skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add GAGAA-HUE/ASHUO-claude-skills --skill design-an-interface. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Design an Interface popular?

It lives in GAGAA-HUE/ASHUO-claude-skills, which has 5 GitHub stars and 2 forks.

Related skills

Domain Modeling

5

GAGAA-HUE/ASHUO-claude-skills

Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural decision, or when another skill needs to maintain the domain model.

AI, LLMs & AgentsIn 2 lists

Git Guardrails Claude Code

5

GAGAA-HUE/ASHUO-claude-skills

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

Git & Code ReviewIn 2 lists

Setup Pre Commit

5

GAGAA-HUE/ASHUO-claude-skills

Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.

Testing & QAIn 2 lists

Ice Cave Explorer

5

GAGAA-HUE/ASHUO-claude-skills

冰洞探险视频剧本 skill —— 为 AI 视频生成工作流产出剧本层资产(亮点设计、场景设定、分镜脚本)。每个产出物对应 120 秒横屏冰洞探险短片的一个环节。不产 AI 工具提示词、不产操作手册。触发词:冰洞、探险视频、冰洞剧本、ice cave。

AI, LLMs & Agents

Claude Handoff

5

GAGAA-HUE/ASHUO-claude-skills

Hand the current conversation off to a fresh background agent that picks up the work immediately.

AI, LLMs & Agents

Magic Fetch

5

npow/claude-skills

Logs capability gaps as they arise during a session — what Claude couldn't do and exactly what tool, access, or data would have made it possible. Use when the user wants to capture integration needs, track where Claude hits walls, build a roadmap from blocked requests, log capability gaps, or says "remember what you couldn't do". Auto-activates when Claude is about to say it cannot access, fetch, or perform something.

AI, LLMs & Agents

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.