Communitygithub.com

xzedm/clipplic-landing

인터페이스를 더 정교하게 만드는 디자인 엔지니어링 원칙. UI 컴포넌트 제작, 프론트엔드 코드 리뷰, 애니메이션, 호버 상태, 그림자, 테두리, 마이크로 인터랙션, 진입/퇴장 애니메이션, 아이콘 선택/리뷰 등 시각적 디테일 작업 시 사용합니다.

clipplic-landing란 무엇인가요?

이 스킬은 UI 인터페이스의 미세한 디테일을 개선하여 전반적인 사용자 경험을 향상시키는 디자인 엔지니어링 원칙을 제공합니다. 주로 Claude Code, Cursor, Codex와 같은 AI 에이전트에서 프론트엔드 코드 리뷰나 UI 컴포넌트 제작 시 활용되며, 경계선 반경, 광학적 정렬, 그림자, 이미지 외곽선, 아이콘, 애니메이션 등 15가지 핵심 원칙을 다룹니다. 각 원칙은 구체적인 CSS 값(예: scale(0.96), translateY, blur 4px 등)을 명시하여 일관된 결과를 보장하며, 'transition: all' 금지, 'will-change' 제한 사용, 애니메이션 중단 가능성 등 성능과 사용성을 모두 고려합니다. 리뷰 결과는 심각도(HIGH/MEDIUM/LOW)와 함께 표 형식으로 제공되며, 검증 과정과 최종 판정(Block/Needs changes/Approve)으로 마무리됩니다. better-typography, better-accessibility, better-layout 스킬과 협력하여 포괄적인 UI 개선을 지원합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xzedm/clipplic-landing/tree/HEAD/.agents/skills/better-ui

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

인터페이스를 더 정교하게 만드는 디테일

훌륭한 인터페이스는 단일 요소에서 나오는 경우가 거의 없습니다. 대부분의 경우 작은 디테일들이 모여 훌륭한 경험을 만들어냅니다. UI 코드를 작성하거나 리뷰할 때 이 원칙들을 적용하세요.

리뷰할 때는 인터페이스 속도를 늦추세요: 브라우저의 애니메이션 패널에서 모션을 10% 속도로 재생하고 모든 상태(호버, 포커스, 활성, 로딩, 빈 상태)를 살펴보세요. 10% 속도에서 어색해 보이는 것은 정상 속도에서 미묘하게 잘못된 것입니다.

프로젝트의 컴포넌트 라이브러리, 토큰, 밀도를 유지하세요. 아래 원칙에서 특정 상호작용 패턴을 규정하는 경우를 제외하고는 프로젝트의 기존 모션 언어를 따르세요.

타이포그래피(텍스트 줄바꿈, 글꼴 렌더링, 표 형식 숫자, 간격)는 better-typography 스킬이 다룹니다. 텍스트 관련 작업은 해당 스킬을 사용하세요. 접근성(히트 영역, 포커스 상태, 키보드 지원, ARIA, 모션 감소)은 better-accessibility 스킬이 다룹니다. 레이아웃 구조(그룹화, 섹션 간 간격, 중단점, 공간적 RTL)는 better-layout 스킬이 다룹니다.

빠른 참조

카테고리사용 시점
표면경계선 반경, 광학적 정렬, 그림자, 이미지 외곽선
애니메이션중단 가능한 애니메이션, 진입/퇴장 전환, 아이콘 애니메이션, 누를 때 크기 조정, 모션 제한
아이콘아이콘 선 굵기, currentColor를 통한 상태, 외곽선 vs 채우기, 크기 조정, RTL 반전
성능전환 구체성, will-change 사용

핵심 원칙

1. 동심원 경계선 반경

외부 반경 = 내부 반경 + 패딩. 중첩된 요소의 반경이 일치하지 않으면 인터페이스가 어색하게 느껴지는 가장 흔한 원인입니다.

2. 기하학적 정렬보다 광학적 정렬

기하학적 중앙 정렬이 어색해 보일 때는 광학적으로 정렬하세요. 아이콘이 있는 버튼, 재생 삼각형, 비대칭 아이콘은 수동 조정이 필요합니다.

3. 그림자는 깊이, 테두리는 구조

깊이를 만들기 위해서만 존재하는 버튼, 카드, 컨테이너에는 투명한 box-shadow 값을 중첩하여 사용하세요. 구조나 상태를 전달하는 테두리(구분선, 레이아웃 분리선, 선택 또는 포커스 상태)는 유지하세요.

4. 중단 가능한 애니메이션

상호작용 상태 변경에는 CSS 전환을 사용하세요. 중간에 애니메이션이 중단될 수 있습니다. 키프레임은 한 번 실행되는 단계별 시퀀스에만 사용하세요.

5. 진입 애니메이션 분할 및 지연

드물게 발생하는 단계별 진입(시퀀스가 계층 구조를 전달하는 데 도움이 될 때)은 콘텐츠를 의미 있는 청크로 나누고 약 100ms 간격으로 지연시키세요. 하나의 컨테이너를 애니메이션하지 마세요. 일상적인 빈도 높은 상호작용에는 지연을 사용하지 마세요.

6. 미묘한 퇴장 애니메이션

전체 높이 대신 작은 고정 translateY를 사용하세요. 퇴장은 진입보다 부드러워야 합니다. 진입과 퇴장 전환 모두에 ease-out을 사용하세요.

7. 상황별 아이콘 애니메이션

표시 여부를 전환하는 대신 opacity, scale, blur로 아이콘을 애니메이션하세요. 정확히 다음 값을 사용하세요: scale은 0.25에서 1로, opacity는 0에서 1로, blur는 4px에서 0px로. 프로젝트의 package.json에 motion 또는 framer-motion이 있으면 해당 패키지의 가져오기 경로를 사용하고(둘 다 있을 경우 기존 인접 가져오기 경로 사용) transition: { type: "spring", duration: 0.3, bounce: 0 }를 사용하세요. bounce는 항상 0이어야 합니다. 모션 라이브러리가 설치되지 않은 경우 두 아이콘을 모두 DOM에 유지하고(하나는 절대 위치) cubic-bezier(0.2, 0, 0, 1)를 사용하는 CSS 전환으로 교차 페이드하세요. 이렇게 하면 종속성 없이 진입 및 퇴장 애니메이션을 모두 얻을 수 있습니다.

8. 이미지 외곽선

일관된 깊이를 위해 이미지에 낮은 불투명도의 미묘한 1px 외곽선을 추가하세요. 색상은 밝은 모드에서 순수 검정(oklch(0 0 0 / 0.1)), 어두운 모드에서 순수 흰색(oklch(1 0 0 / 0.1))이어야 합니다. 슬레이트, 아연 또는 어떤 색조 중립과 같은 검정에 가까운 색상은 절대 사용하지 마세요. 색조가 있는 외곽선은 아래 표면 색상을 흡수하여 이미지 가장자리에 때가 묻은 것처럼 보입니다.

9. 누를 때 크기 조정

클릭 시 미묘한 scale(0.96)은 버튼에 촉각적 피드백을 제공합니다. 항상 0.96을 사용하세요. 0.95보다 작은 값은 절대 사용하지 마세요. 그 아래 값은 과장되어 보입니다. 모션이 산만해질 경우 비활성화할 수 있는 static prop을 추가하세요.

10. 페이지 로드 시 애니메이션 건너뛰기

첫 번째 렌더링에서 진입 애니메이션이 실행되지 않도록 AnimatePresence에 initial={false}를 사용하세요. 의도적인 진입 애니메이션을 깨뜨리지 않는지 확인하세요.

11. transition: all 절대 사용 금지

항상 정확한 속성을 지정하세요: transition-property: scale, opacity. Tailwind의 transition-transform은 transform, translate, scale, rotate를 포함합니다.

12. will-change는 드물게 사용

GPU가 합성할 수 있는 속성인 transform, opacity, filter에만 사용하세요. will-change: all은 절대 사용하지 마세요. 첫 프레임에서 끊김(stutter)이 발견될 때만 추가하세요.

13. 아이콘 선 굵기를 텍스트 굵기에 맞춤

텍스트 옆에 있는 아이콘은 텍스트의 광학적 무게를 전달합니다. 일반(400) 텍스트 옆에는 1.5px 선, 세미볼드(600) 옆에는 2px 선을 사용하세요. 아이콘 세트당 하나의 선 굵기; 한 표면에서 라이브러리를 섞지 마세요.

14. 하나의 SVG, 상태별로 색상 변경

아이콘은 currentColor를 사용하고 상태(호버, 선택, 비활성화)는 별도의 에셋이 아닌 CSS 색상과 불투명도로 처리합니다. 외곽선 변형이 기본값이며, 채우기 변형은 활성 상태를 표시합니다.

15. 모션 제한

빈도 높은 상호작용에는 사용자 지정 애니메이션을 사용하지 마세요. 주의 비용이 트리거될 때마다 반복됩니다. 모션은 결코 유일한 피드백 채널이 되어서는 안 됩니다. 모든 애니메이션 상태 변경에는 정적 단서(색상, 아이콘, 레이블)도 필요합니다.

일반적인 실수

실수수정 방법
밀접하게 중첩된 부모와 자식에 동일한 경계선 반경외부 반경 = 내부 반경 + 패딩 계산
아이콘이 중앙에서 벗어나 보임패딩으로 광학적으로 조정하거나 SVG 직접 수정
테두리를 깊이를 가장하는 데만 사용투명도를 가진 중첩 box-shadow 사용; 구조적 및 상태 테두리 유지
갑작스러운 단계별 진입 또는 상황별 퇴장드문 진입은 지연시키고, 문맥을 유지하는 퇴장은 미묘하게 유지
상태가 있는 아이콘 또는 토글이 페이지 로드 시 기본 상태를 애니메이션해당 AnimatePresence에 initial={false} 추가; 의도적인 페이지 진입 유지
요소에 transition: all 사용정확한 속성 지정
첫 프레임 애니메이션 끊김will-change: transform 추가(드물게)
굵은 텍스트 옆에 가는 선 아이콘선 굵기를 텍스트 굵기에 맞춤
상태별로 별도의 아이콘 에셋하나의 currentColor SVG, CSS로 상태 처리
모든 곳에 채워진 아이콘외곽선이 기본값, 활성 상태에서만 채우기
모든 호버 또는 키 입력 시 진입 애니메이션즉각적인 피드백 또는 ≤150ms 불투명도/색상 전환

리뷰 출력 형식

이 형식은 사용자가 독립적인 UI 다듬기 리뷰를 요청할 때만 사용하세요. better-interface가 리뷰를 조정할 경우, 해당 스킬에 도메인 증거와 결과를 제공하고 출력 형식, 심각도 척도, 통합 규칙, 상한선 및 판정이 우선시되도록 하세요.

독립적인 리뷰는 두 부분으로 제시하세요.

결과 사항

발견된 모든 확인된 결과를 원칙별로 그룹화하세요. 심각도, 위치, 이전, 이후, 이유 열이 있는 마크다운 테이블을 사용하세요. 별도의 "이전:" / "이후:" 줄은 절대 사용하지 마세요.

  • 심각도: HIGH는 상호작용을 오도하거나 응답하지 않게 하거나 반복적으로 방해합니다. MEDIUM은 눈에 띄는 제작 또는 일관성 문제를 만듭니다. LOW는 고립된 다듬기 문제입니다.
  • 위치: path/to/file:line을 인용하세요. 소스 파일이 없는 경우 정확한 화면과 컴포넌트를 대신 인용하세요.
  • 이전 / 이후: 현재 구현과 실행 가능한 대체 코드를 보여주세요.
  • 이유: 위반된 원칙의 이름을 말하고 인터페이스에 어떤 영향을 미치는지 설명하세요.

반복되는 시스템적 문제는 한 행으로 통합하고 영향을 받는 모든 위치를 나열하세요. 결과가 없는 원칙은 생략하세요.

예시

동심원 경계선 반경

심각도위치이전이후이유
LOWsrc/Card.tsx:28카드에 rounded-xl + 내부 버튼에 rounded-xl (p-2)카드에 rounded-2xl (8 + 8 = 16), 내부 버튼에 rounded-lg중첩된 모서리는 동심원이어야 함
LOWsrc/card.css:11두 중첩 표면 모두 border-radius: 16px외부 24px, 내부 16px, 패딩 8px동일한 중첩 반경은 내부 표면이 움푹 들어간 것처럼 보이게 함

누를 때 크기 조정

심각도위치이전이후이유
LOWsrc/Button.tsx:19<button className="...">active:scale-[0.96] transition-transform 추가누름 피드백으로 컨트롤이 반응적으로 느껴짐
MEDIUMsrc/button.css:24누를 때 scale(0.9)scale(0.96)으로 상향0.95 아래 값은 과장되어 보임

검증 및 판정

결과 사항 이후:

  1. 검증: 실행된 정확한 검사와 관찰된 결과를 나열하세요. 모든 관련 상태를 살펴보고 애니메이션이 포함된 경우 10% 속도로 모션을 검사하세요. 검사가 실행되지 않은 경우 아직 검증이 필요한 내용을 명시하세요.
  2. 판정: HIGH 결과가 남아 있으면 Block, MEDIUM 또는 LOW 결과만 남아 있으면 Needs changes, 실행 가능한 결과가 없을 때만 Approve를 반환하세요.

결과가 없는 경우 테이블을 생략하고 "No actionable UI-polish findings"라고 명시한 후 검증을 보고하고 Approve로 끝내세요.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

xzedm/clipplic-landing

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

xzedm/clipplic-landing

Material Design 3 and Android platform guidelines. Use when building Android apps with Jetpack Compose or XML layouts, implementing Material You, navigation, or accessibility. Triggers on tasks involving Android UI, Compose components, dynamic color, or Material Design compliance.

xzedm/clipplic-landing

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

xzedm/clipplic-landing

Design iOS apps following Apple's Human Interface Guidelines. Generate native components, validate designs, and ensure accessibility compliance for iPhone, iPad, and Apple Watch.

xzedm/clipplic-landing

Redesign mobile app UI to feel unmistakably Apple-like, iOS-forward, and native. Use this skill when building iOS apps, applying Apple Human Interface Guidelines, or creating native-feeling mobile interfaces with SF Pro typography, translucency, and system-like components.

xzedm/clipplic-landing

Accessibility engineering for product interfaces, from focus states and keyboard support to ARIA, forms, and screen readers. Use when building or reviewing UI components, modals, menus, forms, custom widgets, or when the user says "make this accessible" or reports keyboard or screen-reader issues. Triggers on accessibility, a11y, WCAG, aria, focus ring, focus-visible, focus trap, keyboard navigation, tab order, tabindex, screen reader, sr-only, aria-live, alt text, hit area, touch target, prefers-reduced-motion, autoplay, toast duration, skip link, semantic HTML, aria-label, form errors, disabled buttons, "not keyboard accessible".

xzedm/clipplic-landing

OKLCH color space and color usage for web projects. Convert hex/rgb/hsl to oklch, generate palettes, check contrast, handle gamut boundaries, theme with Tailwind v4, and apply color with meaning. Triggers on oklch, color conversion, palette generation, contrast ratio, gamut, display p3, design tokens, semantic color tokens, hue drift, chroma, dark mode colors, accent color, color meaning, light and dark appearance, increased contrast.

xzedm/clipplic-landing

Layout structure for web interfaces, from grouping and alignment to reading order, progressive disclosure, and adaptive breakpoints. Use when structuring a page or component, spacing or aligning controls, deciding what collapses at small sizes, handling RTL layout direction, or reviewing frontend code for layout. Triggers on layout, spacing, alignment, grouping, negative space, whitespace, visual hierarchy, reading order, progressive disclosure, breakpoints, responsive layout, container queries, safe area, full-bleed, edge-to-edge, layout margins, RTL layout, logical properties.

xzedm/clipplic-landing

Web typography from choosing fonts to spacing, wrapping and accessibility. Use when picking or pairing typefaces, configuring variable fonts or OpenType features, setting up a type scale, checking heading hierarchy, styling text in components, truncating text, styling underlines, selection, placeholders or carets, or reviewing frontend code for typography. Triggers on typography, fonts, font formats, woff2, variable fonts, font-weight, opentype, font-feature-settings, letter-spacing, line-height, type scale, heading hierarchy, heading levels, tabular numbers, text-wrap, truncation, line clamp, underlines, text-decoration, text selection, iOS input zoom, scaled input text, font smoothing, text contrast, measure, line length, text-box, smart punctuation, drop cap.

xzedm/clipplic-landing

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

xzedm/clipplic-landing

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

xzedm/clipplic-landing

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

xzedm/clipplic-landing

Extract design primitives from a public website and generate starter token files for your project.

xzedm/clipplic-landing

Use this skill alongside figma-use when the task involves translating an application page, view, or multi-section layout into Figma. Triggers: 'write to Figma', 'create in Figma from code', 'push page to Figma', 'take this app/page and build it in Figma', 'create a screen', 'build a landing page in Figma', 'update the Figma screen to match code', 'convert this modal/dialog/drawer/panel to Figma'. This is the preferred workflow skill whenever the user wants to build or update a full page, modal, dialog, drawer, sidebar, panel, or any composed multi-section view in Figma from code or a description. Discovers design system components, variables, and styles from Code Connect files, existing screens, and library search, then imports them and assembles views incrementally section-by-section using design system tokens instead of hardcoded values.

xzedm/clipplic-landing

**MANDATORY prerequisite**: you MUST invoke this skill BEFORE every `use_figma` tool call. NEVER call `use_figma` directly without loading this skill first. Skipping it causes common, hard-to-debug failures. Trigger whenever the user wants to perform a write action or a unique read action that requires JavaScript execution in the Figma file context, e.g. create/edit/delete nodes, set up variables or tokens, build components and variants, modify auto-layout or fills, bind variables to properties, or inspect file structure programmatically.

xzedm/clipplic-landing

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

xzedm/clipplic-landing

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications.

xzedm/clipplic-landing

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

xzedm/clipplic-landing

Fast headless browser for QA testing and site dogfooding. Navigate pages, interact with elements, verify state, diff before/after, take annotated screenshots, test responsive layouts, forms, uploads, dialogs, and capture bug evidence. Use when asked to open or test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots. (gstack)

xzedm/clipplic-landing

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic. A promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames domain skills, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

관련 스킬