design-an-interface

Generate multiple divergent API designs for a software module in parallel.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/drshailesh88/build_playbook --skill design-an-interface-drshailesh88
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-an-interface
Source: https://github.com/drshailesh88/build_playbook/tree/main/vendor/mattpocock-skills/design-an-interface
Command: npx skills add https://github.com/drshailesh88/build_playbook --skill design-an-interface-drshailesh88

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of landing on the wrong interface shape early, by forcing comparison of multiple radically different API designs before you commit.

Core Features & Use Cases

  • Parallel sub-agent design options: Generates 3+ competing interface designs at the same time so you explore divergent API shapes rather than iterating on a single idea.
  • Requirement-driven interface generation: Starts from gathered requirements (callers, operations, constraints, and what to hide vs expose).
  • Structured comparison and synthesis: Compares designs on simplicity, general-purpose vs specialized fit, implementation efficiency, depth, and ease of correct use.

Use cases: Designing an API for a module, exploring interface options when requirements are fuzzy, comparing multiple possible module shapes (especially when the user says “design it twice”), or when you need to evaluate trade-offs across competing paradigms.

Quick Start

Ask for an interface design by saying: "Design an interface for [your module description] and generate 3+ radically different API options with example usage and trade-offs."

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 multiple API shapes for a module before committing to one?

Generating multiple interface designs forces you to explore divergent API shapes before committing. It compares competing designs on simplicity, efficiency, and trade-offs, preventing you from committing to the wrong module shape early when requirements are fuzzy.

What is the best way to compare different software design options for an API?

The best way to compare different software design options is to generate multiple interface designs in parallel and evaluate them against structured criteria like simplicity, implementation efficiency, and ease of correct use before making a final synthesis recommendation.

How do I structure an interface design when my software requirements are fuzzy?

When requirements are fuzzy, gather caller operations and constraints, then generate 3+ competing interface designs with structured outputs including signatures, usage examples, internals, and trade-offs to clarify the best module shape.

Can I evaluate trade-offs across competing paradigms for a module interface?

Yes, you can evaluate trade-offs across competing paradigms by generating multiple radically different API shapes simultaneously. Each design includes a structured comparison of simplicity, general-purpose versus specialized fit, and implementation depth.

What does it mean to design an interface twice and how does parallel generation help?

Designing an interface twice means creating multiple radically different API shapes to compare alternatives rather than iterating on a single idea. Parallel sub-agent runs generate these competing designs simultaneously to explore divergent module shapes efficiently.