Skip to content

Navigation Menu

Sign in
Sign up

Latest commit

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

Zypsy Product Design Skills

A behavioral instruction file that teaches AI coding agents how to design like Zypsy. It shapes how the agent reasons about UI work, not just what it produces visually, but how it structures information, handles states, writes copy, designs for AI, and builds systems.

Background

Zypsy is a design studio based in SF, USA. Over a decade of shipping products for funded startups and global brands, certain principles kept proving out across every engagement. This file is an attempt to encode those principles in a form an AI agent can actually use.

See It In Action

Example 1 (Web App)

When the skill is applied, the output has clear visual hierarchy, consistent spacing, and intentional component choices.

Dashboard UI after applying the skill

Prompt executed without any post-generation edits. What you see is exactly what the agent produced.


Example 2 (Mobile App)

When the skill is applied, each screen stays focused, results are prioritized not listed, and the visual language earns trust.

Finance app UI after applying the skill

Prompt executed without any post-generation edits. What you see is exactly what the agent produced.


Installation

Claude Code

First, add the marketplace source:

/plugin marketplace add zypsycom/product-design-skills

Then install the plugin:

/plugin install zypsy-product-design-skills

Cursor

  1. Open Cursor Settings (Cmd+Shift+J / Ctrl+Shift+J)
  2. Go to Rules & CommandProject Rules → Add Rule → Remote Rule (GitHub)
  3. Enter: https://github.com/zypsycom/product-design-skills.git

Any agent

npx skills add zypsycom/product-design-skills

Skills are extracted individually, so you'll need to upgrade them manually.


Who it's for

Developers building their own products who want AI-assisted UI that doesn't default to generic patterns.

Designers using AI coding tools who want the agent to carry some of the design thinking, not just generate passable HTML.

Design-aware founders and PMs who are using Cursor or similar tools to prototype and want the output to be structurally sound, not just visually presentable.

Note: It is not intended to replace a designer on complex products. It is intended to raise the quality ceiling on AI-assisted output, and to make the gap between "AI-generated" and "designed" a bit smaller.

Response modes

The skill uses two modes, triggered automatically based on request scope.

Quick mode : a component question, a critique, a fast check. The skill applies internally. The response is direct, no structured sections, no intake questions.

Full mode : an app concept, a multi-screen flow, a new product area. The skill runs the four-question intake first, then responds using the Section 10 structure.

A note on expectations

This skill can meaningfully improve output quality in areas where AI coding agents tend to fall short like structural decisions, information hierarchy, state coverage, AI feature design, copy quality, and anti-pattern avoidance.

It will not turn an AI agent into a senior product designer. Context still matters. Judgment still matters. The four intake questions exist because no skill can replace understanding the actual product, the actual user, and the actual stakes.

About

Zypsy design skills for AI agents

Resources

Stars

12 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

AltStyle によって変換されたページ (->オリジナル) /