Agent skill

Design An Interface

by ProgrammerAnthony in ProgrammerAnthony/Anything-Extract

使用并行子 agent 为某个模块生成多个根本不同的接口设计。适用于用户希望设计某个 API、探索接口选项、对比模块形状(module shapes),或提到“design it twice(把它设计两遍)”。

MITAuto-check passed

Install Design An Interface

skills CLI
$ npx skills add ProgrammerAnthony/Anything-Extract --skill design-an-interface -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ProgrammerAnthony/Anything-Extract design-an-interface --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ProgrammerAnthony/Anything-Extract.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/design-an-interface .claude/skills/design-an-interface && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
design-an-interface
GitHub stars
139
Token cost
~448 tokens
SKILL.md length
90 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

使用并行子 agent 为某个模块生成多个根本不同的接口设计。适用于用户希望设计某个 API、探索接口选项、对比模块形状(module shapes),或提到“design it twice(把它设计两遍)”。

  • Works in 5 steps: 收集需求(Gather Requirements) → 生成设计方案(并行子代理 Parallel Sub-Agents) → 展示设计方案 → …
  • SKILL.md covers 工作流(Workflow), 评价标准(Evaluation Criteria) and 反模式(Anti-Patterns)
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Design An Interface is an agent skill from ProgrammerAnthony/Anything-Extract. 使用并行子 agent 为某个模块生成多个根本不同的接口设计。适用于用户希望设计某个 API、探索接口选项、对比模块形状(module shapes),或提到“design it twice(把它设计两遍)”。

Its SKILL.md is about 450 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: 高效文档识别&知识库&本地启动,前后端;整合QAnything、dify等思想和源码,快速批量可靠提取文档关键信息并导出. The licence is MIT.

Example prompts

  • “design it twice(把它设计两遍)”
  • “/design-an-interface”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. 收集需求(Gather Requirements)
  2. 生成设计方案(并行子代理 Parallel Sub-Agents)
  3. 展示设计方案
  4. 对比设计方案
  5. 归纳(Synthesize)

What it can do on your machine

Read from SKILL.md and the folder at commit f1ed557. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Design An Interface loads about 448 tokens when it runs. Until then it costs about 31 tokens; SKILL.md has 90 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~31
When it runs · the whole SKILL.md, loaded when a task matches
~448

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ProgrammerAnthony/Anything-Extract at commit f1ed557, republished under its MIT licence (© ProgrammerAnthony). 90 words, ~448 tokens.

Download SKILL.mdSave it as .claude/skills/design-an-interface/SKILL.md (or your agent's skills folder).
name
design-an-interface
description
使用并行子 agent 为某个模块生成多个根本不同的接口设计。适用于用户希望设计某个 API、探索接口选项、对比模块形状(module shapes),或提到“design it twice(把它设计两遍)”。

设计一个接口(Design an Interface)

基于《A Philosophy of Software Design》里的 “Design It Twice(把它设计两遍)”:你的第一个想法通常不会是最好的。生成多个根本不同的设计方案,然后进行对比。

工作流(Workflow)

1. 收集需求(Gather Requirements)

在开始设计前先理解:

  • 这个模块解决什么问题?
  • 谁会作为调用方?(其他模块、外部用户、测试)
  • 关键操作是什么?
  • 有哪些约束?(性能、兼容性、既有模式)
  • 应当隐藏什么、暴露什么?

提问:这个模块需要做什么?谁会使用它?

2. 生成设计方案(并行子代理 Parallel Sub-Agents)

使用 Task 工具并行启动 3 个以上的子 agent。每个子 agent 都必须产出**根本不同(radically different)**的方案。

给每个子 agent 的提示模板:

为以下内容设计一个接口:[模块描述]

需求:[已收集到的需求]

为这个设计分配约束:[给每个 agent 设定不同的约束]

- Agent 1: "尽量减少方法数量——目标是最多 1-3 个方法"
- Agent 2: "尽量提升灵活性——支持很多用例"
- Agent 3: "为最常见的场景优化"
- Agent 4: "借鉴 [特定范式/库] 的思路"

输出格式:
1. 接口签名(types/methods)
2. 用法示例(调用方如何使用)
3. 该设计内部隐藏了什么复杂度
4. 采用该方式的取舍(trade-offs)
3. 展示设计方案

分别展示每个设计:

  1. 接口签名:类型、方法、参数
  2. 使用示例:调用方在实践里如何使用
  3. 隐藏了什么:将复杂度保留在内部

让用户在对比之前先逐个理解每种方案的含义,因此展示顺序应按方案逐一给出。

4. 对比设计方案

在展示完全部设计后,从这些维度进行对比:

  • 接口简洁性:更少的方法、更简单的参数
  • 通用型 vs 专用型:灵活性 vs 专注度
  • 实现效率:这种形状是否允许高效实现?
  • 深度(Depth):小接口隐藏显著复杂度(好) vs 大接口但实现很薄(坏)
  • 正确使用的容易度 vs 被误用的容易度

请用文字(prose)讨论取舍,而不是用表格。重点指出不同设计最分歧的地方。

5. 归纳(Synthesize)

通常最好的设计会融合多个选项的洞见。追问:

  • 哪个设计最符合你的主要使用场景?
  • 是否有来自其他设计、值得纳入的元素?

评价标准(Evaluation Criteria)

来自《A Philosophy of Software Design》:

  • 接口简洁性(Interface simplicity):方法更少、参数更简单 => 更容易学习与正确使用。
  • 通用型(General-purpose):在不改动接口的前提下能覆盖未来用例。但要警惕过度通用。
  • 实现效率(Implementation efficiency):接口的形状是否能让实现变得高效?还是迫使你在内部做尴尬的权衡?
  • 深度(Depth):小接口隐藏显著复杂度 => 深模块(good)。大接口但实现很薄 => 浅模块(avoid)。

反模式(Anti-Patterns)

  • 不要让子 agent 产出相似的设计——要强制根本差异
  • 不要跳过对比——对比的价值在于“形成对照”
  • 不要去实现——这项工作只关注接口形状
  • 不要基于“实现成本/劳动量”去做评价

© ProgrammerAnthony, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/design-an-interface of ProgrammerAnthony/Anything-Extract.

Open the folder on GitHubat commit f1ed557

Compare with similar skills

Design An Interface next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Design An Interface compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Design An Interface this skillProgrammerAnthony/Anything-Extract139—~448Automated safety check: PassMIT
Network Interface Healthaffaan-m/ECC274k1 repos~1.4kAutomated safety check: PassMIT
Es Modulesthedaviddias/Front-End-Checklist74k—~482Automated safety check: PassMIT
Make Interfaces Feel Betteraffaan-m/ECC274k1 repos~1.2kAutomated safety check: PassMIT
Performing Hardware Security Module Integrationmukul975/Anthropic-Cybersecurity-Skills34k—~617Automated safety check: PassApache-2.0
HTML Ppt Course Modulenexu-io/open-design100k—~1.4kAutomated safety check: PassApache-2.0

Similar skills

  • Diagnose interface errors, drops, CRCs, duplex mismatches, flapping, speed negotiation issues, and counter trends on routers, switches, and Linux hosts.

    274k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Es Modules

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing scripts, client components, bundles, or runtime behavior related to Use ES modules (import/export).

    74k GitHub stars~482 tokensUpdated yesterday
    Auto-check passed
  • Apply concrete design-engineering details that make interfaces feel polished.

    274k GitHub starsUsed in 1 repo~1.2k tokens
    Frontend & DesignAuto-check passed
  • Performing Hardware Security Module Integration

    mukul975/Anthropic-Cybersecurity-Skills

    Integrates Hardware Security Modules (HSMs) via the PKCS11 interface using python-pkcs11, performing key generation, signing, encryption, verification, and token/slot queries against SoftHSM2, AWS…

    34k GitHub stars~617 tokensUpdated 1 mo ago
    SecurityAuto-check passed
  • HTML Ppt Course Module

    nexu-io/open-design

    A first-30-days onboarding module for new hospitality hires — the behaviors, the practice, the checks, and the manager follow-up.

    100k GitHub stars~1.4k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Sci Fi Interface

    sickn33/agentic-awesome-skills

    Web and App implementation guide for Sci-Fi Interface Design.

    47k GitHub starsUsed in 1 repo~3.1k tokens
    MobileAuto-check passed

More from ProgrammerAnthony/Anything-Extract

All 13 skills in this repo
  • Backend Code Review

    ProgrammerAnthony/Anything-Extract

    指导在项目(python项目)中队后端代码进行质量、安全、可维护性与最佳实践审查,基于既定规则清单。适用于用户请求对 backend/ 下后端文件(如 .py)进行审查、分析或改进。不用于前端文件(如 .tsx、.ts、.js)。支持待提交变更审查、代码片段审查、按文件审查。

    139 GitHub stars~791 tokensUpdated 4 mo ago
    Auto-check passed
  • Frontend Code Review

    ProgrammerAnthony/Anything-Extract

    指导在项目中对前端代码(Next.js/React/TypeScript/Tailwind 等)进行结构、可维护性、性能与一致性审查,基于既定规则清单。适用于用户请求审查 .tsx/.ts/.js/.jsx 等前端文件或前端目录下的页面与组件。不用于后端代码(如 .py)。

    139 GitHub stars~957 tokensUpdated 4 mo ago
    Auto-check passed
  • TDD

    ProgrammerAnthony/Anything-Extract

    使用 RED-GREEN-重构(red-green-refactor)循环进行测试驱动开发。适用于用户希望用 TDD 构建新功能或修复 bug,提到 “red-green-refactor”,希望使用集成测试,或询问“test-first development(先写测试)”。

    139 GitHub stars~572 tokensUpdated 4 mo ago
    Auto-check passed
  • Ubiquitous Language

    ProgrammerAnthony/Anything-Extract

    从当前对话中抽取 DDD 风格的“统一语言”术语表(ubiquitous language glossary),标记歧义,并提出规范的术语选择。保存为 UBIQUITOUSLANGUAGE.md。适用于用户希望定义领域术语、构建术语表、固化用词并强化术语一致性,或提到 “domain model” / “DDD”(领域模型与 DDD)。

    139 GitHub stars~647 tokensUpdated 4 mo ago
    Auto-check passed
  • Write A Skill

    ProgrammerAnthony/Anything-Extract

    以正确的技能结构、渐进式披露与打包资源来创建新的 agent 技能。适用于用户希望创建、编写或构建新的技能. An agent skill from ProgrammerAnthony/Anything-Extract.

    139 GitHub stars~407 tokensUpdated 4 mo ago
    Auto-check passed
  • Architecture Doc

    ProgrammerAnthony/Anything-Extract

    指导在项目中编写、更新与使用架构文档(ARCHITECTURE.md)。在根目录维护架构文档,修改前后需阅读文档;文档关注最终结果与流程串联,不陷入实现细节。适用于新增/变更功能、重构、或需要理解系统整体时。

    139 GitHub stars~606 tokensUpdated 4 mo ago
    Auto-check passed

Questions about Design An Interface

What does Design An Interface do?

使用并行子 agent 为某个模块生成多个根本不同的接口设计。适用于用户希望设计某个 API、探索接口选项、对比模块形状(module shapes),或提到“design it twice(把它设计两遍)”。. Design An Interface is an agent skill from ProgrammerAnthony/Anything-Extract.

How do I install Design An Interface in Claude Code?

Run `npx skills add ProgrammerAnthony/Anything-Extract --skill design-an-interface -a claude-code`. Or copy the skill folder (.agents/skills/design-an-interface in ProgrammerAnthony/Anything-Extract) into .claude/skills/design-an-interface in your project. Claude Code loads it when a task matches its description.

How do I install Design An Interface in Codex?

Run `npx skills add ProgrammerAnthony/Anything-Extract --skill design-an-interface -a codex`. Or copy the skill folder (.agents/skills/design-an-interface in ProgrammerAnthony/Anything-Extract) into .agents/skills/design-an-interface in your project. Codex loads it when a task matches its description.

Can I use Design An Interface in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ProgrammerAnthony/Anything-Extract --skill design-an-interface -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/design-an-interface, .gemini/skills/design-an-interface, .github/skills/design-an-interface and .opencode/skills/design-an-interface in your project.

What does Design An Interface need to run?

SKILL.md names no scripts, command-line tools or credentials: Design An Interface is instructions for the agent only.

Does Design An Interface access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Design An Interface safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Design An Interface use?

Design An Interface is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Design An Interface use?

About 448 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Design An Interface?

Skills that share tags, products or a category with Design An Interface: Network Interface Health (affaan-m/ECC, 274k stars), Es Modules (thedaviddias/Front-End-Checklist, 74k stars), Make Interfaces Feel Better (affaan-m/ECC, 274k stars) and Performing Hardware Security Module Integration (mukul975/Anthropic-Cybersecurity-Skills, 34k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Design An Interface?

ProgrammerAnthony (a GitHub user) maintains it in ProgrammerAnthony/Anything-Extract, which has 139 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on May 13, 2026.

Source: ProgrammerAnthony/Anything-Extract on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.