Token导航 LogoToken导航TokenDH.com
待分类只读github未标认证来源可访问许可证需确认审计通过

design-guide设计指南

Agent Skill

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

总安装

245

周安装

10

GitHub Stars

公开资料未说明

下载量

79
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

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

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

命令行安装

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

skills.shnpx skills
npx skills add https://github.com/variel/skills --skill design-guide

简介

design-guide 用于辅助界面设计、视觉规范和交互体验优化。

  • 它适合整理页面结构、生成 UI 方案并检查视觉一致性。
  • 使用时需结合品牌系统和用户任务,避免堆砌装饰元素。
  • 涉及真实页面改动时应通过截图或浏览器预览验证文本溢出和对齐。
  • 适用宿主包括 Codex、Claude、Cursor、Gemini CLI,接入前应确认版本、权限和运行环境要求。

SKILL.md

Design Guide — 사용자 중심 인터페이스 설계

철칙: 디자인은 사용자의 문제를 해결하기 위해 존재한다.

1. 디자인의 목적

화면 위의 모든 픽셀은 이 질문에 답해야 한다 — "이것이 사용자의 목표 달성에 기여하는가?"

필수: 이 요소가 없으면 사용자가 목표를 달성할 수 없다
유용: 이 요소가 있으면 목표 달성이 더 쉬워진다
제거: 둘 다 아니다

사람들은 제품을 사지 않는다. 더 나은 버전의 자기 자신을 산다. 기능을 나열하지 말고, 사용자가 도달할 상태를 보여줘야 한다.

단계질문
Before지금 사용자가 겪는 고통은 무엇인가?
After제품을 쓴 후의 모습은 어떠한가?
Bridge제품이 어떻게 연결하는가?
Feeling지배적 감정은 무엇인가?

이 전환 맵 없이 디자인을 시작하지 말라.

요소가 다음 네 가지를 지원하지 않으면 존재해서는 안 된다:

  1. 탐색 — 원하는 곳으로 이동
  2. 이해 — 현재 상태와 맥락 파악
  3. 판단 — 선택지 비교, 결정
  4. 실행 — 의도를 행동으로

2. 사용자의 눈으로 보라

모든 화면은 이 세 질문에 즉시 답할 수 있어야 한다:

  • "이게 뭐하는 건지 알겠는가?"
  • "내가 원하는 걸 할 수 있는가?"
  • "다음에 뭘 해야 하는지 보이는가?"

이 세 질문에 즉시 답할 수 없는 화면은 재설계하라.

사용자는 읽지 않고 훑는다

F자 패턴으로 훑고 눈에 띄는 것에 반응한다. 따라서:

  • 첫 1~2개 요소가 화면의 역할과 행동을 설명해야 한다
  • 헤드라인은 부가 설명 없이도 이해 가능해야 한다
  • 사용자가 추측해야 한다면, 재설계하라

인지 부하를 줄여라

Recognition over Recall. 사용자에게 이전 상태를 기억하도록 요구하지 말라.

  • 관련 행동을 필요한 시점에 노출하라
  • 내비게이션은 예측 가능하게 유지하라
  • 컨트롤 위치를 일관되게 배치하라
  • 시스템이 사용자 대신 기억하게 하라

점진적 공개(Progressive Disclosure)를 적용하라

모든 기능을 한 번에 보여주는 것은 친절이 아니라 폭력이다.

  • 핵심 정보를 먼저 보여줘라
  • 고급 컨트롤은 맥락에 따라 드러내라
  • 세부 뷰는 요청 시에만 펼쳐라
복잡함(Complexity) ≠ 혼란(Confusion)
- 복잡함: 기능이 많다. 관리할 수 있다.
- 혼란: 구조가 없다. 어디서부터 시작해야 할지 모른다.

모든 행동에 피드백을 제공하라

상호작용 후의 침묵은 용납할 수 없다.

상황반드시 제공할 피드백
버튼 클릭즉각적인 시각적 반응
데이터 로딩로딩 상태 표시
작업 성공명확한 확인 메시지
오류 발생구체적 오류 설명 + 해결 방법
데이터 없음빈 상태 안내 + 다음 행동 제안
권한 부족이유 설명 + 대안 안내

3. 반드시 지켜야 할 원칙

3.1 목적 우선(Purpose First)

  • 화면당 하나의 지배적인 사용자 질문에 답하라
  • 화면당 하나의 주된 행동을 지원하라
  • 여러 목표가 경쟁하면 별도 화면으로 분리하라
  • 다목적 잡동사니 화면을 만들지 말라

3.2 지배 영역 규칙(Dominant Region Rule)

  • 시각적 무게는 중요도를 반영해야 한다
  • 보조 영역은 종속적으로 배치하라
  • 동일한 무게의 레이아웃을 피하라
  • 위계(hierarchy)는 선택이 아니라 필수다

3.3 행동 위계(Action Hierarchy)

수준처리 방식
주된 행동화면당 하나. 시각적으로 가장 돋보이게 하라
보조 행동시각적으로 축소하라
파괴적 행동명확하게 구분하고 실행 전 확인을 받아라
드문 행동오버플로 메뉴에 배치하라

3.4 구조적 일관성(Structural Consistency)

  • 비슷한 문제는 비슷한 방식으로 해결하라
  • 내비게이션 논리를 안정적으로 유지하라
  • 간격은 일관된 척도를 따르게 하라
  • 예측 가능성이 신뢰를 만든다

3.5 확장성(Scalability)

  • 데이터가 10배 늘어나도 구조가 깨지지 않게 설계하라
  • 기능이 추가되어도 위계가 무너지지 않게 하라
  • 오늘의 5개 항목이 내일의 500개가 되어도 작동하는 구조를 만들어라

4. 설계 방법론

빼기의 기술

1. 필요한 모든 것을 나열하라
2. "이것 없이 사용자가 목표를 달성할 수 있는가?" → "예"라면 제거하라
3. 남은 것들의 우선순위를 정하라
4. 우선순위에 따라 시각적 무게를 배분하라

밀도를 의도적으로 선택하라

모드용도특징
빽빽함(Compact)트레이딩, 모니터링높은 정보 밀도, 좁은 간격
보통(Medium)일반적인 기본값균형 잡힌 밀도
여유(Airy)온보딩, 설정넓은 여백, 큰 요소

하나의 화면 안에서 밀도 모드를 임의로 혼합하지 말라.

공간을 구조로 사용하라

  • 하나의 화면에 하나의 지배적 축을 유지하라
  • 장식용 구분선 대신 여백으로 구분하라
  • 장식 위에 구조를 두어라(Structure over ornament)

엔티티 무결성을 지켜라

어떤 엔티티를 표현하든: 이름은 눈에 띄게, 상태는 명확하게, 핵심 메타데이터를 표시하고, 행동을 명백하게 드러내라.

반응형 설계 원칙

디바이스지켜야 할 원칙
모바일단일 지배 칼럼. 보조 패널은 시트/스택. 수평 스크롤 금지
태블릿전환적 구조 논리를 적용하라
데스크톱다중 영역 허용. 높은 밀도 가능

스케일링은 반드시 명확성을 보존해야 한다.

적응 논리(Adaptation Logic)

문맥에서 유추한 뒤 결정하라:

  1. 지배 영역은 무엇인가
  2. 주된 행동은 무엇인가
  3. 적절한 밀도는 어느 수준인가
  4. 점진적 공개의 깊이는 어디까지인가

5. 플랫폼별 가이드 — 반드시 참조하라

언제 읽는가 (Hard Gate)

디자인 작업을 시작하기 전에, 대상 플랫폼의 개요 문서를 반드시 먼저 읽어라. 이 단계를 건너뛰면 안 된다.

사용자 요청 수신
  ↓
대상 플랫폼 판별 (웹 앱 / 모바일 앱 / 랜딩 페이지 / 슬라이드)
  ↓
★ 해당 플랫폼 개요 문서를 읽는다 ← 이 단계가 필수
  ↓
개요 문서의 워크플로우에 따라 세부 문서를 순서대로 참조
  ↓
설계 시작
  ↓
visual-and-verification.md로 마감 검증

복합 요청(예: "웹 앱 + 랜딩 페이지")이면 관련 개요 문서를 모두 읽되, 화면마다 지배적 패러다임 하나를 명확히 선택하라.

플랫폼별 진입점

플랫폼개요 문서하위 세부 문서
웹 앱web-app.md→ paradigms, components, practical
모바일 앱mobile-app.md→ paradigms, components, practical
랜딩 페이지landing-page.md→ paradigms, sections, practical
슬라이드slides.md(단일 문서에 통합)

각 개요 문서에 설계 워크플로우(Step 1→2→3)가 정의되어 있다. 해당 워크플로우를 따라 필요한 세부 문서를 순서대로 참조하라. 세부 문서로 직접 점프하지 말라.


6. 안티패턴 — 이것을 하지 말라

범용 안티패턴

안티패턴왜 문제인가대안
다목적 잡동사니 화면목적 불명확, 인지 과부하화면을 분리하라
동일 무게 레이아웃초점 부재지배 영역을 만들어라
아이콘만으로 텍스트 대체추측 필요, 접근성 저하레이블을 추가하라
모든 기능 한 번에 노출사용자 압도점진적 공개 적용
행동 후 무반응불안과 불신즉각 피드백 제공
임의 밀도 혼합비일관적 느낌의도적 밀도 모드 선택
장식용 구분선 남발시각적 소음여백으로 구분
하드코딩 색상값유지보수 불가시맨틱 토큰 사용

미학적 안티패턴 (AI 디자인에서 특히 주의)

안티패턴대안
범용 폰트(Inter, Roboto, Arial) 반복 사용독특한 폰트, 매번 다르게
보라색 그라디언트 + 흰 배경 클리셰대담한 색상 선택
예측 가능한 쿠키커터 패턴맥락에 맞는 고유한 구조
단색 배경에 안주분위기와 텍스처 추가
매 생성마다 같은 폰트/색상 수렴의식적으로 변화를 주어라
장식용 요소 남발기능적 이유가 없으면 제거

7. 디자인 완료 시 반드시 검증하라

visual-and-verification.md를 반드시 참조하라. 이 파일은 미학적 방향(타이포, 색상, 모션, 공간), 검증 체크리스트, 안티패턴을 담고 있으며, 플랫폼과 무관하게 모든 디자인의 마감 단계에서 적용해야 한다.

빠른 체크리스트

  • 처음 방문한 사용자가 3초 안에 화면 목적을 이해할 수 있는가?
  • 다음에 해야 할 행동이 명백한가?
  • 하나의 지배적 시각 영역이 있는가?
  • 모든 상태(로딩, 빈, 에러, 성공)가 고려되었는가?
  • 간격이 일관된 척도를 따르는가?
  • 데이터가 10배 늘어나도 깨지지 않는가?

상세 검증(사용자/구조/일관성/확장성 관점별 체크리스트, 콘텐츠 우선 검증, 시각 검증)은 visual-and-verification.md에 정의되어 있다.

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明,方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用;具体调用方式请以来源页面和 README 为准。

平台分布

Codex

33.23%
按下载量换算26

Claude

30.81%
按下载量换算24

Cursor

20.67%
按下载量换算16

Gemini CLI

10.28%
按下载量换算8

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

只读

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

安装前确认

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

来源信息

继续浏览同类 Skills