Token导航 LogoToken导航

Agent Skill · 前端设计

design-principles(设计原则)

用于辅助界面设计、视觉规范、排版、配色、布局和交互体验优化。它适合让 Agent 根据产品场景整理页面结构、生成 UI 方案、检查视觉一致性或改进组件层级。使用时需要结合现有品牌、设计系统和用户任务,不应只堆装饰元素;涉及真实页面改动时,应通过截图或浏览器预览检查文本溢出、对齐和响应式表现。

design-principles 是前端设计类 Agent Skill,可用宿主为 Codex、Claude、Cursor、Gemini CLI,通过GitHub 仓库获取,权限为只读;许可证信息还不明确,第三方扫描已通过,按安装量在前端设计类的 10,216 个 Skill 里排第 5,550。

总安装 649周安装 26GitHub Stars 27下载 210核验 2026-05-01

安装说明

本站只整理中文说明,不托管安装包,也不代用户安装。
GitHub
许可证
unknown

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:design-principles(设计原则)
来源仓库:https://github.com/hermeticormus/libreuiux-claude-code
仓库路径:skills/design-principles
安装命令:
npx skills add https://github.com/hermeticormus/libreuiux-claude-code --skill design-principles
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/hermeticormus/libreuiux-claude-code --skill design-principles

这个 Skill 是做什么的

前端设计类 Skill 关注页面结构、视觉规范和组件写法,输出通常是可运行的界面代码。

用于辅助界面设计、视觉规范和交互体验优化。适合整理页面结构、生成 UI 方案或检查一致性。使用时需结合品牌系统和用户任务,避免堆砌装饰元素。涉及真实页面改动时,应通过截图检查文本溢出和对齐。响应式表现需在浏览器中预览确认。design-principles 属于前端设计类 Skill,可作为该场景下的辅助能力补充。

来源仓库内路径:skills/design-principles

上手步骤

4 步
  1. 1

    确认自己的宿主工具

    公开资料标注支持 Codex、Claude、Cursor、Gemini CLI;先确认自己用的是其中之一,再按对应工具的 Skills 目录放置。

  2. 2

    拿到安装命令

    可以直接复制的命令是 npx skills add https://github.com/hermeticormus/libreuiux-claude-code --skill de…;命令里的占位符换成自己的路径或密钥再执行。

  3. 3

    安装后重启宿主

    命令执行完要完全退出宿主工具再打开,让新装的 Skill 被重新扫描到,否则列表里可能看不到。

  4. 4

    按最小权限试用

    它标注为只读,先用只读任务试一次,确认行为符合预期再扩大使用范围。

常见问题

6 条

design-principles 怎么安装?

在终端执行 npx skills add https://github.com/hermeticormus/libreuiux-claude-code --skill design-princ…。装完完全退出宿主工具再打开,让它重新扫描本地 Skill。

design-principles 支持哪些 AI 工具?

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录,一般也能手动放进去,但要自己确认触发方式是否一致。

design-principles 需要什么权限?

权限级别是只读。该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

design-principles 是免费的吗?

公开资料没有标注明确许可证,收费和商用限制都无法确认。正式使用前请到来源仓库核对授权说明。

design-principles 用的人多吗?

公开数据是累计安装 649 次,近一周安装 26 次,下载 210 次,GitHub 27 星。这些数字来自第三方目录统计,只能当作热度参考,不代表质量或安全性。

design-principles 安全吗?

第三方扫描结果为通过,但这只覆盖已知的静态检查项,不能替代自己读一遍源码和安装命令。

值得选的地方和要先想清楚的地方

值得选的地方

  • 同时适配 4 种工具,换客户端不用重新找替代品。
  • 第三方扫描已通过,常见的高风险行为没有命中。
  • 标注为只读权限,试用阶段不容易误改本地文件。

先想清楚的地方

  • 许可证没有明确标注,能不能商用、能不能再分发都不确定。
  • 第三方目录整理,版本更新和行为细节以来源仓库为准。

适不适合你

更适合

  • 已经在用 Codex,想直接扩展它能力的人。
  • 需要处理前端设计类任务、又不想每次都手写提示词的人。
  • 只想先试试效果、不希望它改动本地文件的人。

不太适合

  • 需要明确授权才能用到公司项目里的场景。
  • 需要厂商级技术支持和 SLA 的生产系统。

前端设计类 Skill 对比

6 个同类
Skill总安装GitHub 星权限许可证扫描
frontend-design

前端设计 · Codex、Claude

8,823,360126,072只读MIT通过
vercel-composition-patterns

Vercel 组合模式 · Codex、Claude

3,858,81625,893需要联网MIT通过
vercel-react-native-skills

Vercel React native skills 前端 · Codex、Claude

2,468,66425,878只读MIT通过
adapt

adapt 搜索 · Codex、Claude

2,027,04023,125操作浏览器未明确通过
bolder

bolder 分析 · Codex、Claude

2,004,28823,130只读未明确通过
design-principles

设计原则 · 本页

64927只读未明确通过

按安装量取同分类前几名;数字来自第三方目录统计,只作热度参考,不代表质量结论。

SKILL.md 原文

Design Principles

The fundamental laws governing visual perception and communication. These principles are not opinions—they're observations about how human vision and cognition work.

When to Use This Skill

  • Making visual design decisions
  • Evaluating whether a design "works"
  • Explaining why something feels off
  • Teaching design fundamentals
  • Debugging design problems

Core Principles

1. Visual Hierarchy

The Law: Not all elements are equally important. Design must guide the eye.

Establishing Hierarchy:

ToolWhat It DoesExample
ScaleLarger = more importantHero headlines vs. body text
WeightHeavier = more importantBold headings vs. light body
ColorSaturated/contrasting = attentionPrimary CTA vs. secondary
PositionTop-left (in LTR) = first seenLogo placement
SpaceMore space = more importanceGenerous padding around CTAs
DepthShadows/elevation = prominenceFloating action buttons

Testing Hierarchy: Blur the design at 50%. Can you still identify:

  • The primary focal point?
  • The secondary information?
  • The action you should take?

2. Gestalt Principles

The Law: The brain organizes visual elements into meaningful groups.

Proximity

*Elements near each other are perceived as related.*

Good:  [Label]          [Label]
       [Input]          [Input]
       (8px gap)        (8px gap)

       (32px gap between groups)

       [Label]          [Label]
       [Input]          [Input]

Bad:   [Label]  [Label]  [Label]  [Label]
       [Input]  [Input]  [Input]  [Input]
       (equal spacing destroys grouping)

In Tailwind:

  • Related items: space-y-2 (8px)
  • Unrelated groups: space-y-8 (32px) or divide-y
Similarity

*Elements that look alike appear grouped.*

When multiple card types exist, make categories visually distinct:

  • Same category: same border-radius, shadow, padding
  • Different category: different color, icon style, or layout
Continuity

*The eye follows smooth paths.*

Applied to navigation:

[Home] → [Products] → [About] → [Contact]
         ↓
    [Category A]
    [Category B]
    [Category C]

Lines don't need to be visible—implied lines work.

Closure

*The mind completes incomplete shapes.*

Useful for:

  • Logo design (WWF panda, FedEx arrow)
  • Icon design (implied shapes)
  • Cards that bleed off screen (implies more content)
Figure/Ground

*Clear separation between subject and background.*

Common failures:

  • Text on busy image backgrounds
  • Low contrast between layers
  • Unclear what's clickable vs. static

3. The Rule of Thirds

The Law: Placing subjects at 1/3 intersections creates natural balance.

+-------+-------+-------+
|       |       |       |
|   ●   |       |       |  ← Focal point at intersection
+-------+-------+-------+
|       |       |       |
|       |       |       |
+-------+-------+-------+
|       |       |       |
|       |       |       |
+-------+-------+-------+

For web layouts:

  • Hero text left-aligned, hitting left-third
  • Key visuals placed at intersection points
  • Whitespace fills remaining thirds

4. Golden Ratio (1:1.618)

The Law: Proportions found in nature feel inherently pleasing.

Applications:

  • Content width to sidebar: 1:1.618
  • Heading to body size: 1.618:1
  • Spacing multipliers: 16px → 26px → 42px

Tailwind approximation:

Base unit: 16px (text-base)
Medium:    24px (text-2xl ≈ 16 × 1.5)
Large:     40px (text-4xl ≈ 16 × 2.5)

5. Visual Balance

The Law: Compositions should feel stable, not falling.

Symmetrical Balance

  • Equal weight on both sides
  • Formal, stable, traditional
  • Use for: corporate, luxury, authoritative

Asymmetrical Balance

  • Unequal elements balanced by visual weight
  • Dynamic, interesting, modern
  • Use for: creative, startups, editorial

Visual Weight Factors:

ElementAdds Weight
SizeLarger = heavier
ColorDarker, saturated = heavier
ComplexityDetailed = heavier
PositionLower = heavier
IsolationAlone = heavier

6. Alignment

The Law: Elements should share visual lines, even if not explicitly drawn.

Strong Alignment:

[Logo]
_________________________
[Navigation links          ]
_________________________

[Headline              ]
[Subhead               ]
[CTA Button]

(Everything shares left edge)

Weak Alignment:

    [Logo]
[Navigation links]
    [Headline]
   [Subhead   ]
    [CTA Button]

(No consistent edge)

7. Repetition

The Law: Consistent patterns create unity and learnability.

Elements to keep consistent:

  • Border radius (all cards same)
  • Shadow levels (same depth for same importance)
  • Spacing units (multiples of 4px or 8px)
  • Color application (primary always means action)
  • Typography hierarchy (h2 always looks like h2)

8. Contrast

The Law: Difference creates interest and guides attention.

Types of contrast:

  • Size contrast: Large headings, small captions
  • Color contrast: Dark on light, warm accents
  • Weight contrast: Bold headlines, regular body
  • Style contrast: Serif headings, sans body
  • Spacing contrast: Tight groups, generous separation

Minimum contrast requirements:

  • Body text: 4.5:1 ratio (WCAG AA)
  • Large text (18px+): 3:1 ratio
  • UI components: 3:1 ratio

9. White Space (Negative Space)

The Law: What you leave empty is as important as what you fill.

Functions of white space:

  1. Breathing room: Prevents cognitive overload
  2. Grouping: Separates distinct content areas
  3. Emphasis: Isolated elements command attention
  4. Luxury signal: Generous space suggests premium

Common failures:

  • Cramming elements to "fit more"
  • Equal spacing everywhere (creates monotony)
  • Fear of empty space

Tailwind spacing guide:

Tight (related):     gap-2 (8px)
Standard (siblings): gap-4 (16px)
Section (groups):    gap-8 (32px) or py-12
Page (major):        gap-16 (64px) or py-24

10. Unity

The Law: All elements should feel like they belong together.

Achieving Unity:

  • Consistent color palette
  • Unified typography system
  • Repeated patterns and components
  • Aligned grids
  • Harmonious proportions

Testing Unity: Take any element and place it elsewhere. Does it still feel like it belongs? If not, the system lacks unity.

Quick Reference: Principles Applied

ProblemPrincipleSolution
"It feels cluttered"White SpaceIncrease padding/margins
"I don't know where to look"HierarchyEstablish clear focal point
"It feels disconnected"Unity/RepetitionApply consistent patterns
"It feels boring"ContrastAdd variation in size/color/weight
"Things seem randomly placed"AlignmentCreate shared edges
"The groups are confusing"Proximity/SimilarityCluster related items
"It feels off balance"BalanceRedistribute visual weight

Resources

  • references/gestalt-principles.md: Deep dive on perceptual grouping
  • references/visual-hierarchy.md: Comprehensive hierarchy techniques
  • references/color-theory.md: Color psychology and application
  • references/typography-fundamentals.md: Type as design element
  • references/composition-rules.md: Layout and arrangement
  • assets/principles-checklist.md: Evaluation checklist

平台分布

Codex

33.71%
按下载量换算71

Claude

28.08%
按下载量换算59

Cursor

19.71%
按下载量换算41

Gemini CLI

8.98%
按下载量换算19

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

只读

该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。目前只有一个公开来源,建议同时核对源仓库。

继续浏览同类 Skills