CtrlK
BlogDocsLog inGet started
Tessl Logo

design-an-interface

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.

80

Quality

100%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tight, well-organized process skill: an unambiguous sequenced workflow, concrete actionable sub-agent prompts, built-in quality gates via anti-patterns and a success checklist, and clean self-contained sectioning with no reference nesting.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: it does not re-explain basic programming concepts, and the only definitions (deep vs. shallow module) are skill-specific framing that earns their place rather than padding.

3 / 3

Actionability

For an instruction-only planning skill it gives copy-paste-ready guidance — concrete divergent constraints per sub-agent (e.g. "Minimize method count — 1 to 3 entry points max"), a 4-item agent return spec, named comparison axes, and exact capture targets (`.gsd/DECISIONS.md`, `S##-CONTEXT.md`).

3 / 3

Workflow Clarity

A clearly sequenced 6-step process is backed by an anti-patterns section that acts as error-recovery feedback ("Kill and re-spawn") and a final success_criteria checklist; the operation is non-destructive planning, so the destructive-feedback cap does not apply.

3 / 3

Progressive Disclosure

The skill is self-contained with no bundle files and no nested references, organized into clearly delimited sections (objective, context, core_principle, process, anti_patterns, success_criteria) that provide easy navigation; nothing that should be split out is inlined.

3 / 3

Total

12

/

12

Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, well-structured description: concrete actions, explicit natural-language triggers, and a clear what+when structure in third-person imperative voice. It is distinguishable from adjacent planning skills and avoids vague fluff.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Produce 3+ radically different designs", "compare them in prose", "synthesize a recommendation" — matching the anchor for listing several specific concrete actions rather than vague language.

3 / 3

Completeness

It explicitly answers both what (produce/compare/synthesize designs) and when via an explicit "Use when..." clause, satisfying the highest anchor; a missing Use-when clause would have capped this at 2, but it is present.

3 / 3

Trigger Term Quality

Natural trigger phrases a user would actually say are present — "design an interface", "shape this API", "design it twice", "explore module boundaries" — giving good coverage of realistic invocation language.

3 / 3

Distinctiveness Conflict Risk

It carves a clear niche — designing one's own module/API interface shape during planning — with distinct triggers unlikely to fire for unrelated skills like library selection or implementation work.

3 / 3

Total

12

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
gsd-build/gsd-2
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.