product-design

Diagnose product surfaces by grounding business models and framing user view models.

Updated Jan 27, 2026
One-click install
npx skills add https://github.com/SmallAi-API/smaihub --skill product-design-smallai-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: product-design
Source: https://github.com/SmallAi-API/smaihub/tree/main/.agents/skills/product-design
Command: npx skills add https://github.com/SmallAi-API/smaihub --skill product-design-smallai-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams often design from screenshots or assume the interface reflects what the product actually does, leading to surfaces that misrepresent business semantics, promise nonexistent actions, or organize information around system entities instead of user tasks. This Skill establishes what the business actually models before any design decision, then frames the user's view model so the surface answers real retrieval and decision needs. ## Core Features & Use Cases - Business Model Grounding: Enumerate concepts, states, roles, obligations, and business events from domain evidence, including capabilities the current surface hides. - Structural Diagnosis: Identify errors that are wrong regardless of taste, such as decision inboxes rendered as error logs or buttons promising business events that do not exist. - Scoped Deliverables: Produce design specs with reality-check logs, honest scope buckets (modeled/exposed/not modeled), and optional prototypes via three run modes: Discover, Frame, and Materialize. - Use Case: Given a vague request like "redesign our home surface," ground the domain model, discover that three of four message types were never surfaced, and deliver a spec for a decision inbox organized by required action rather than producing entity. ## Quick Start Ask the agent to analyze what a product surface should be and why, starting from the business model rather than the current screen.

Frequently Asked Questions about product-design

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

FAQPage Schema
How do I figure out what a product surface should contain before designing it?

Ground the business model first: enumerate concepts, states, roles, and what each state obliges someone to do. Then frame the user's view model around lookup objects and first-scan questions, and diagnose structural errors before proposing any information architecture.

How to tell if a UI button or feature is based on a real business capability?

For every element, name the business event it produces in domain language. If no event exists, the affordance is theatre and should be deleted, marked NEW on the prototype, or explicitly proposed as a domain change with cost assessment.

When should I use product-design versus a UX or audit skill?

Use product-design before or during framing to decide what a surface should be and why. Use ux for interaction behavior while building, ux-audit after something exists, and design-prototype only when a materialized prototype is needed to resolve uncertainty.

Can this skill design from a screenshot of the existing interface?

No. Designing from the surface is an explicit anti-pattern because the screen often hides capabilities the business already models. The skill grounds the domain model directly and treats the current surface as a hypothesis, not evidence.

What deliverables does a product design run produce?

Depending on the authorized mode, it produces an evidence map and diagnosis (Discover), a view model and information architecture (Frame), or a design spec with a reality-check log and optional prototype (Materialize). Nothing is written unless the user requests an artifact.