design-an-interface

Generate multiple API interface designs with usage examples and a recommended boundary.

1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/grant-vine/wunderkind --skill design-an-interface-grant-vine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-an-interface
Source: https://github.com/grant-vine/wunderkind/tree/main/skills/design-an-interface
Command: npx skills add https://github.com/grant-vine/wunderkind --skill design-an-interface-grant-vine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams tackle high-complexity API design by exploring multiple interface options, evaluating tradeoffs, and aligning module boundaries before implementation.

Core Features & Use Cases

  • Generate multiple distinct interface designs with concrete usage examples.
  • Compare designs on simplicity, safety, and migration costs to recommend a single boundary.
  • Use case: when API boundaries between modules, services, or adapters are unclear and a decision impacts future evolution.

Quick Start

Provide the current module boundaries and callers, and ask the skill to generate multiple designs with usage examples and a recommended boundary.

Frequently Asked Questions about design-an-interface

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design robust API boundaries for high-stakes module refactors?

To structure API design decisions, you provide current module boundaries and callers. The tool then generates multiple distinct interface designs, each with concrete usage examples, and compares them to recommend a single boundary for migration.

What is the best way to evaluate API design tradeoffs between multiple public interfaces?

Evaluating API design tradeoffs means comparing multiple generated interface options against current repo constraints. You assess simplicity, safety, and migration costs across these designs to select a single boundary that minimizes risks for future evolution.

When do I need to explore multiple interface designs before implementation?

You need to explore multiple interface designs when significant refactors risk costly changes or when multiple public interfaces exist. This approach prevents expensive migration errors by evaluating tradeoffs and aligning module boundaries before implementation begins.

How do I align module boundaries when planning a complex service migration?

To align module boundaries, you analyze current repo constraints and generate multiple interface designs with concrete usage examples. Comparing these designs on simplicity, safety, and migration costs yields a recommended boundary for a smooth migration.

Does API design evaluation work for existing repositories with complex dependencies?

Yes, API design evaluation works for existing repositories by explicitly requiring the assessment of current repo constraints. It handles scenarios with multiple public interfaces by generating usage examples and recommending a boundary that accommodates those dependencies.