Communitygithub.com

xzedm/clipplic-landing

웹 인터페이스의 레이아웃 구조화: 그룹화와 정렬에서부터 읽기 순서, 점진적 공개, 반응형 중단점까지 다룹니다. 페이지나 컴포넌트를 구조화하거나, 컨트롤의 간격과 정렬을 조정하거나, 작은 화면에서 무엇을 접을지 결정하거나, RTL 레이아웃 방향을 처리하거나, 프론트엔드 코드의 레이아웃을 검토할 때 사용하세요.

clipplic-landing란 무엇인가요?

이 스킬은 웹 UI 레이아웃의 구조적 원칙을 제공합니다. 위치, 간격, 정렬이 계층 구조를 어떻게 전달하는지, 그리고 레이아웃이 크기 조정, 번역, RTL 반전 등 스트레스 상황에서도 견고함을 유지하는 방법을 설명합니다. Tailwind, 일반 CSS, CSS-in-JS 등 프로젝트의 기존 스타일 시스템을 활용하며, 두 번째 스타일링 방식을 도입하지 않습니다. 수치 값은 기존 밀도나 간격 체계가 없는 인터페이스의 시작점으로 사용되며, 프로젝트 토큰은 히트 영역, 확대/축소, 지역화, 뷰포트 스트레스 테스트에서 사용 가능할 때 유지됩니다. 핵심 원칙에는 공간을 통한 그룹화, 컨트롤과 콘텐츠의 구분, 공유 가장자리 정렬, 중요도 순서, 숨겨진 콘텐츠 암시, 타겟 간 여유 공간, 가장자리에서 버튼 인셋, 콘텐츠 블리드와 컨트롤 플로트, 콘텐츠 기반 중단점, 문자열 성장 계획이 포함됩니다. 또한 일반적인 레이아웃 실수와 그 해결책, 독립적인 레이아웃 검토를 위한 출력 형식을 제공합니다.

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

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

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

문서

구조를 전달하는 레이아웃

레이아웃은 한 글자도 읽기 전에 구조를 전달합니다. 위치, 간격, 정렬은 그 자체로 계층 구조를 나타내며, 넉넉한 공간은 장식보다 효과적입니다. 좋은 레이아웃은 스트레스에도 잘 견딥니다. 크기를 조정하고, 번역하고, RTL로 반전시켜도 여전히 견고해야 합니다. UI 코드를 작성하거나 리뷰할 때 이러한 원칙을 적용하고, 모든 변경 사항은 프로젝트의 기존 스타일링 시스템(Tailwind, 일반 CSS, CSS-in-JS)으로 표현해야 하며, 두 번째 스타일링 방식을 도입해서는 안 됩니다.

히트 영역 크기와 포커스 동작은 better-accessibility 스킬에서 다루며, 시각적 다듬기(둥근 모서리, 그림자, 애니메이션)는 better-ui 스킬에서, 줄 길이와 텍스트 간격은 better-typography 스킬에서 다룹니다.

아래의 숫자 값은 기존 밀도나 간격 체계가 없는 인터페이스를 위한 시작점으로 취급하세요. 의도적인 플랫폼 크롬, 간결한 전문 도구, 프로젝트 토큰은 히트 영역, 확대/축소, 지역화, 뷰포트 스트레스 테스트에서 여전히 사용 가능할 때 유지하세요.

빠른 참조

카테고리사용 시기
그룹화 및 정렬공간 vs 구분선, 정렬 가장자리, 논리적 속성, 중요도 순서
간격 및 적응성타겟 간 간격, 레이아웃 여백, 점진적 공개, 전체 너비 콘텐츠, 중단점, 국제화 성장

핵심 원칙

1. 선이 아닌 공간으로 그룹화

음의 공간이 주요 그룹화 도구이고, 배경 모양이 그 다음이며, 구분선은 공간만으로 구조를 전달할 수 없는 경우에만 마지막으로 사용합니다. 그룹 간 간격은 그룹 내 간격의 최소 2배(8px 그룹 내 → 16px+ 그룹 간)여야 하며, 그렇지 않으면 그룹화가 노이즈로 읽힙니다.

2. 컨트롤을 콘텐츠와 구분

상호작용 요소는 상호작용 가능해 보여야 합니다: 배경 모양, 테두리 또는 일관된 배치 영역을 사용하세요. 컨트롤을 인접한 정적 텍스트와 동일하게 스타일링하지 마세요.

3. 공유 가장자리에 정렬

정렬 가장자리를 선택하고 고수하세요. 모든 벗어난 가장자리는 노이즈로 읽힙니다. 각 하위 수준에 대해 하나의 프로젝트 간격 단계를 사용하세요(16px는 유용한 기본값입니다). 방향 종속 레이아웃에는 논리적 속성(padding-inline-start, margin-inline-end)을 사용하고, 물리적 왼쪽/오른쪽은 진정한 물리적 형상에만 사용하세요.

4. 중요도 순서

가장 중요한 콘텐츠는 상단과 선행 가장자리 근처에 위치하며, 읽기 순서는 위에서 아래로, 선행에서 후행으로 흐릅니다. 왼쪽/오른쪽이 아닌 선행/후행으로 생각하세요.

5. 숨겨진 콘텐츠 암시

점진적 공개에는 가시적인 어포던스가 필요합니다. 프로젝트의 기존 신호를 사용하세요. 기존 신호가 없으면, 다음 항목이 스크롤 가장자리에서 16–32px만큼 살짝 보이도록 하거나 공개 컨트롤을 표시하세요. 신호 없이 숨겨진 콘텐츠는 존재하지 않는 것과 같습니다.

6. 타겟 간 여유 공간

기존 밀도 체계가 없으면, 인접한 테두리 또는 채우기 컨트롤 사이에는 12px로 시작하고, 테두리 없는 텍스트 및 아이콘 전용 컨트롤 주변에는 24px의 여백을 두세요. better-accessibility 히트 영역이 겹치지 않고 컨트롤이 시각적으로 구분되는 경우, 간결한 레이아웃은 덜 사용할 수 있습니다.

7. 가장자리에서 버튼 인셋

콘텐츠 레이아웃에서 전체 너비 버튼은 레이아웃 여백 안쪽(모바일에서 인라인 16px부터 시작)에 두고 가시적인 둥근 모서리를 유지하세요. 가장자리 간 동작은 의도적으로 기존 플랫폼 또는 애플리케이션 크롬을 따르고, 안전 영역을 고려하며, 시스템 UI와 구분될 때 허용됩니다.

8. 콘텐츠는 블리드, 컨트롤은 플로트

배경과 미디어는 뷰포트 가장자리까지 확장되고, 컨트롤과 텍스트는 레이아웃 여백과 안전 영역(env(safe-area-inset-*)) 안에 유지됩니다. 고정 크롬은 콘텐츠 레이어 위에 떠 있으며, 콘텐츠를 막지 않습니다.

9. 깨질 때까지 구조 유지

중단점은 장치 사전 설정이 아닌 콘텐츠에서 비롯됩니다. 확장된 레이아웃을 진정으로 맞을 때까지 유지하고 늦게 접으세요. 컴포넌트 수준 적응에는 컨테이너 쿼리를 선호하세요. 가장 작은 크기와 가장 큰 크기를 먼저 테스트하세요.

10. 성장 및 잘림 계획

보편적인 백분율에 의존하지 말고 상당하고 언어 종속적인 문자열 성장을 계획하세요. 텍스트 컨테이너에 고정 너비나 높이를 사용하지 말고, 행이 줄바꿈되도록 하세요. 크기 조정이나 스크롤로 인해 잘리는 곳에 중요한 작업을 배치하지 말고, 일반 흐름 또는 제품에 적합한 안정적인 크롬에서 도달 가능하게 유지하세요.

일반적인 실수

실수수정
간격으로 충분한 곳에 구분선 사용구분선 제거, 그룹 간 간격 두 배로 늘리기
지역화 가능한 레이아웃에서 margin-left / padding-right 사용margin-inline-start / padding-inline-end로 변경
콘텐츠 레이아웃 버튼이 실수로 뷰포트에 닿음프로젝트 여백 안쪽으로 인셋; 의도적인 플랫폼 크롬 유지
완료된 것처럼 보이는 캐러셀/스크롤러다음 항목이 가장자리에서 16–32px만큼 살짝 보이게 하기
인접한 컨트롤이 합쳐지거나 확장된 히트 영역이 겹침프로젝트 스케일을 사용하여 간격 증가; 12px/24px를 시작점으로 사용
기본값이기 때문에 768/1024에 중단점 설정콘텐츠가 실제로 맞지 않는 지점에서 중단
하나의 언어에 맞춰진 고정 너비 텍스트 컨테이너max-width + 줄바꿈; 의사 지역화 및 대표 로케일 테스트
패널 하단(잘리기 쉬운 곳)의 기본 작업고정 위치 또는 안전 영역 패딩이 있는 안정적인 크롬 사용

검토 출력 형식

이 형식은 사용자가 독립적인 레이아웃 검토를 요청할 때만 사용하세요. better-interface가 검토를 조정하는 경우, 해당 스킬에 도메인 증거와 결과를 제공하고, 출력 형식, 심각도 척도, 통합 규칙, 상한선, 평결이 우선시되도록 하세요.

독립적인 검토는 두 부분으로 표시하세요.

결과

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

  • 심각도: HIGH는 지원되는 뷰포트에서 콘텐츠나 작업을 차단합니다. MEDIUM은 계층 구조, 읽기 순서 또는 적응성을 해칩니다. LOW는 고립된 정렬 또는 간격 조정입니다.
  • 위치: path/to/file:line을 인용하세요. 산출물에 소스 파일이 없으면 정확한 화면과 컴포넌트를 대신 인용하세요.
  • 이전 / 이후: 현재 레이아웃과 실행 가능한 대안을 보여주세요.
  • 이유: 위반된 원칙과 이해도 또는 적응성에 미친 영향을 명시하세요.

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

예시

공간, 선이 아닌 것으로 그룹화

심각도위치이전이후이유
LOWsrc/Settings.tsx:41모든 설정 행에 border-b테두리 제거; 그룹 내 space-y-2 및 그룹 간 space-y-8 사용간격이 더 적은 시각적 노이즈로 그룹화를 전달합니다
LOWsrc/ProfileForm.tsx:58양식 섹션 사이에 <hr>각 섹션 제목에 mt-10으로 대체섹션 계층 구조가 반복되는 규칙에 의존해서는 안 됩니다

공유 가장자리에 정렬

심각도위치이전이후이유
LOWsrc/Card.tsx:24카드 텍스트 pl-4, 카드 아이콘 pl-3둘 다 동일한 pl-4 가장자리에 정렬공유 가장자리가 읽기 쉬운 구조를 만듭니다
MEDIUMsrc/Nav.css:19margin-left: 16pxmargin-inline-start: 16px물리적 속성은 방향 인식 레이아웃을 깨뜨립니다

확인 및 평결

결과 표 다음:

  1. 확인: 관련 뷰포트 너비, 읽기 순서, 확대/축소 및 RTL 상태에서 실행된 정확한 검사와 관찰된 결과를 나열하세요. 검사가 실행되지 않은 경우, 아직 무엇을 확인해야 하는지 명시하세요.
  2. 평결: HIGH 결과가 남아 있으면 차단, MEDIUM 또는 LOW 결과만 남아 있으면 변경 필요, 실행 가능한 결과가 없을 때만 승인으로 종료하세요.

결과가 없으면, 테이블을 생략하고 "실행 가능한 레이아웃 결과 없음"을 명시하고, 확인 사항을 보고한 후 승인으로 종료하세요.

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

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

Design engineering principles for making interfaces feel polished. Use when building UI components, reviewing frontend code, implementing animations, hover states, shadows, borders, micro-interactions, enter/exit animations, choosing or reviewing icons, or any visual detail work. Triggers on UI polish, design details, "make it feel better", "feels off", stagger animations, border radius, optical alignment, image outlines, box shadows, icons, icon stroke weight, icon states, motion restraint.

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.

관련 스킬