SkillAgentSearch skills...

product-ui-design

This skill should be used when the user asks to "polish the UI", "improve product UX", "design app controls", "reduce friction", or "create design rules". Design usable, distinctive product interfaces for new or existing apps.

Install / Use

npx skills add fcakyon/claude-codex-settings --skill product-ui-design

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

83/100

Category

Design

Supported Platforms

Universal

Our assessment of product-ui-design

product-ui-design scores 83/100 on our quality scale, 213th of 270 Design skills we index.

Its SKILL.md is 8.4 KB long, split into 7 sections and no code examples: a thorough specification that gives an agent plenty to work with.

With 1,153 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
11/20
Description
15/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so product-ui-design is actively maintained.
  • It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.

Automated pattern scan on 2026-11-20. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

product-ui-design compared with similar skills

All 4 of these similar skills score higher than product-ui-design; compare them before choosing.

SkillScoreStarsUpdatedFormat
product-ui-design (this skill)by fcakyon831.2k56d agoSKILL.md
taste-skillby Leonxlnx100118.9k11d agoCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10040.2k10d agoCLAUDE.md
algorithmic-artby anthropics100177.9k58d agoSKILL.md
pptxby anthropics100177.9k58d agoSKILL.md

Frequently asked questions

How do I install product-ui-design?
Run npx skills add fcakyon/claude-codex-settings --skill product-ui-design. The install tabs above show the steps for each supported agent.
Which AI agents does product-ui-design work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is product-ui-design safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is product-ui-design still maintained?
The repository was last updated about 2 months ago, so product-ui-design is actively maintained.

name: product-ui-design description: This skill should be used when the user asks to "polish the UI", "improve product UX", "design app controls", "reduce friction", or "create design rules". Design usable, distinctive product interfaces for new or existing apps.

Product UI design

Use this skill for product flows, screens and controls, including products without a design system. Use writing guidance for interface copy and frontend testing guidance for browser execution when available. For new visual concepts or substantial art direction, use the OpenAI or Anthropic frontend design skill while preserving the product workflow and approved identity.

Understand the job before choosing the treatment

Inspect the actual product, related screens, components, assets and design rules. Identify the user's goal, the next meaningful action, the decisions required and where the flow loses context. For a new product, derive these from the brief and real content. Ask only for decisions that accessible evidence cannot resolve.

Make the next action apparent through placement, hierarchy and plain labels. Remove unnecessary steps and repeated explanations. Preserve selections, drafts and the originating destination through sign-in, connection, retries and navigation. Keep destructive actions deliberate and recovery beside the failed action. Do not hide useful actions merely to make a screenshot cleaner.

Separate small preferences from ongoing work. Connecting several accounts, switching between them and browsing their content may belong in a product workspace alongside related work. Settings should not become that workflow by accident. A single optional connection does not automatically need its own primary navigation item.

Create or improve product design rules

Read existing rules before changing a screen. Preserve approved identity unless the user asks to change it. If rules are missing or weak, derive a coherent system from the audience, task, assets and useful references. Show the direction through rendered UI, then fold accepted choices and user corrections into the existing design document. Replace stale or contradictory rules instead of appending a history of rejected treatments. Create a design document only when requested or required by project guidance.

Define the choices future screens need: brand assets and tone, font roles and type scale, color roles and supported themes, spacing and density, control sizes, radii and elevation, icon family, content hierarchy and responsive behavior. Explain why distinguishing choices fit the product. Keep rules aligned with actual tokens and components. Separate established decisions from proposals and unverified behavior.

Different products should retain different identities. A media catalog can prioritize imagery, an evaluation workspace can prioritize comparable evidence, and a live presentation can use louder visuals than its setup forms. Do not export one product's palette, font or ban on a visual treatment as a universal rule.

Choose surfaces for the amount of work

Choose rows, lists, tables, panels or open space according to the content. Group related preferences into one coherent divided list rather than a card for every small choice. Put the label and a useful hint beside a natural-width control. A three-option choice rarely needs to span the page. At narrow widths, wrap the control below its label without truncating choices or forcing horizontal scrolling.

A preference that manages a growing collection can show a count and a Manage action. Open a bounded manager with search, identifying metadata and row actions instead of rendering the entire collection inside Settings. Keep search and actions reachable while the list scrolls. Preserve the query, scroll and useful focus after a mutation, and show loading, empty, pending and failure states where they belong.

Keep infrequent creation forms from occupying the main reading or browsing surface. A visible Create action can open a focused dialog, popover or dedicated page according to the form's length and complexity. An icon-only launcher needs an accessible name. Keep the chosen account and draft through failure, and make the effect of submission clear, including whether it changes an external service or sends invitations.

For sequential setup, use one cohesive ordered list. Keep row actions explicitly left aligned (justify-start text-left) and primary labels untruncated. Keep unordered secondary tools at a natural width, not a stretched 2+1 arrangement. Pair empty-state onboarding with a real theme-aware product preview when one exists. Spend visual emphasis on the next meaningful action instead of adding decoration to every section.

Make controls belong to the product

Use the product's font and control hierarchy deliberately rather than accepting the component library's default treatment. Choose label size, weight, line height and spacing for the role. Check that the intended font actually loads. Align labels, icons and action columns, and choose comfortable density instead of enlarging controls to fill space.

Choose fills, borders and corner radii by role. Pills and accent-colored labels can be appropriate, but should not become the default for every action. Check the actual foreground against its surface, especially pale fills in light mode. Use a restrained secondary treatment and a clear committing action consistent with the product's own hierarchy. Do not add a generic AI sparkle to an otherwise clear action label as decoration.

Text and fields must be readable in every supported theme. Check text contrast, field boundaries, placeholders, focus and disabled states against their actual backgrounds. Target WCAG AA contrast, including 4.5:1 for ordinary text and 3:1 for large text and essential control boundaries. Do not use color as the only signal. Keep visible labels, keyboard access and touch targets usable. Use at least 16px editable input text on phones to avoid automatic zoom where applicable.

Use accurate icons and integration assets

Prefer a recognizable icon or real integration logo when it reduces reading or helps recognition. Keep concise visible text when a symbol would be ambiguous. Icon-only actions need an accessible name and an understandable discovery path.

Search existing assets and components first. Use verified brand assets or a maintained brand asset library. Never replace a real logo with a typed initial, emoji or approximate drawing. Preserve its proportions and recognizable colors, using official theme variants where needed. Decorative logos should not duplicate accessible labels. Keep the product icon family consistent in size, stroke weight and optical alignment. An action rarely needs both an action icon and a provider mark unless each adds useful meaning.

Read control examples when implementing preference rows, collection managers, form actions or account controls. They illustrate composition with HeroUI v3, not a required dependency, palette or universal visual style. Check the project's installed APIs before adapting them.

Render, inspect and show

Inspect and show the affected interface at desktop and mobile widths and in every supported theme. Use representative real content or clearly identified fixtures. Check the scale the workflow can reach: empty, one item and a realistic larger collection, such as 40 or more entries, with long values and multiple accounts where relevant. These are coverage examples, not fixed limits. Do not add a theme the product does not support just to fill a comparison.

Prefer screenshots of the actual implementation at matching states and viewports. If a recreation is necessary, label it clearly, use the real assets and styling, and state what remains unverified. Never substitute an approximate preview for acceptance of the running UI. Display evidence inline using the host's supported visual tools, rather than handing back file paths alone.

Exercise the main interaction and inspect the result after it changes. Check hierarchy, density, contrast, focus, clipping, wrapping, scrolling and mobile reachability. Verify that a larger collection does not push unrelated settings out of reach and that recovery retains the user's work. Reuse existing test and QA owners for observable behavior rather than testing CSS classes or copying implementation inventories. A passing build or small fixture does not prove usable composition. Report specific remaining limitations without claiming uninspected views passed.

Related Skills

View on GitHub
GitHub Stars1.2k
CategoryDesign
Updated1mo ago
Forks110

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions