Communitygithub.com

tmnhutwork/Landingpage-Photo-Retouch

shadcn/ui 구성 요소(Tailwind + Radix UI 기반), Tailwind CSS 유틸리티 우선 스타일링, 캔버스 기반 비주얼 디자인으로 아름답고 접근성 높은 사용자 인터페이스를 만듭니다.

Landingpage-Photo-Retouch란 무엇인가요?

이 스킬은 React 기반 프레임워크(Next.js, Vite, Remix, Astro)에서 shadcn/ui, Tailwind CSS, 캔버스 기반 비주얼 디자인 시스템을 활용하여 아름답고 접근성 높은 UI를 구축하는 방법을 제공합니다. 접근성 높은 대화상자, 양식, 테이블, 탐색 구성 요소를 포함한 포괄적인 구성 요소 라이브러리를 안내하며, 유틸리티 우선 스타일링, 반응형 디자인, 다크 모드 지원, 테마 사용자 정의를 다룹니다. 또한 시각적 디자인 원칙과 캔버스 작업 흐름을 포함하는 철학 기반의 비주얼 디자인 시스템을 제공하여 최소한의 텍스트와 최대의 시각적 효과를 통해 박물관 수준의 구성을 가능하게 합니다. 자동화 스크립트는 구성 요소 설치 및 설정 생성을 용이하게 하여 신속한 프로토타이핑과 일관된 스타일링 패턴을 지원합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tmnhutwork/Landingpage-Photo-Retouch/tree/HEAD/.agents/skills/ui-styling

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

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

문서

UI 스타일링 스킬

shadcn/ui 구성 요소, Tailwind CSS 유틸리티 스타일링, 캔버스 기반 비주얼 디자인 시스템을 결합하여 아름답고 접근성 높은 사용자 인터페이스를 만드는 포괄적인 스킬입니다.

참고 자료

이 스킬을 사용해야 할 때

다음과 같은 경우에 사용하세요:

  • React 기반 프레임워크(Next.js, Vite, Remix, Astro)로 UI 구축
  • 접근성 높은 구성 요소(대화상자, 양식, 테이블, 탐색) 구현
  • 유틸리티 우선 CSS 접근 방식으로 스타일링
  • 반응형 모바일 우선 레이아웃 생성
  • 다크 모드 및 테마 사용자 정의 구현
  • 일관된 토큰을 가진 디자인 시스템 구축
  • 비주얼 디자인, 포스터 또는 브랜드 자료 생성
  • 즉각적인 시각적 피드백을 통한 신속한 프로토타이핑
  • 복잡한 UI 패턴(데이터 테이블, 차트, 명령 팔레트) 추가

핵심 스택

구성 요소 계층: shadcn/ui

  • Radix UI 프리미티브를 통한 사전 구축된 접근성 구성 요소
  • 복사-붙여넣기 배포 모델(구성 요소가 코드베이스에 직접 위치)
  • TypeScript 우선, 완전한 타입 안전성
  • 복잡한 UI를 위한 구성 가능한 프리미티브
  • CLI 기반 설치 및 관리

스타일링 계층: Tailwind CSS

  • 유틸리티 우선 CSS 프레임워크
  • 빌드 타임 처리, 런타임 오버헤드 없음
  • 모바일 우선 반응형 디자인
  • 일관된 디자인 토큰(색상, 간격, 타이포그래피)
  • 자동 데드 코드 제거

비주얼 디자인 계층: 캔버스

  • 박물관 수준의 비주얼 구성
  • 철학 기반 디자인 접근 방식
  • 정교한 시각적 커뮤니케이션
  • 최소한의 텍스트, 최대의 시각적 효과
  • 체계적인 패턴과 세련된 미학

빠른 시작

구성 요소 + 스타일링 설정

shadcn/ui와 Tailwind 설치:

npx shadcn@latest init

CLI가 프레임워크, TypeScript, 경로 및 테마 기본 설정을 묻습니다. 이렇게 하면 shadcn/ui와 Tailwind CSS가 모두 구성됩니다.

구성 요소 추가:

npx shadcn@latest add button card dialog form

유틸리티 스타일링과 함께 구성 요소 사용:

import { Button } from "@/components/ui/button"
import { Card, CardHeader, CardTitle, CardContent } from "@/components/ui/card"

export function Dashboard() {
  return (
    <div className="container mx-auto p-6 grid gap-6 md:grid-cols-2 lg:grid-cols-3">
      <Card className="hover:shadow-lg transition-shadow">
        <CardHeader>
          <CardTitle className="text-2xl font-bold">Analytics</CardTitle>
        </CardHeader>
        <CardContent className="space-y-4">
          <p className="text-muted-foreground">View your metrics</p>
          <Button variant="default" className="w-full">
            View Details
          </Button>
        </CardContent>
      </Card>
    </div>
  )
}

대안: Tailwind 전용 설정

Vite 프로젝트:

npm install -D tailwindcss @tailwindcss/vite
// vite.config.ts
import tailwindcss from '@tailwindcss/vite'
export default { plugins: [tailwindcss()] }
/* src/index.css */
@import "tailwindcss";

구성 요소 라이브러리 가이드

사용 패턴, 설치 및 구성 예제가 포함된 포괄적인 구성 요소 카탈로그입니다.

참고: references/shadcn-components.md

다음 내용을 다룹니다:

  • 양식 및 입력 구성 요소 (Button, Input, Select, Checkbox, Date Picker, Form validation)
  • 레이아웃 및 탐색 (Card, Tabs, Accordion, Navigation Menu)
  • 오버레이 및 대화상자 (Dialog, Drawer, Popover, Toast, Command)
  • 피드백 및 상태 (Alert, Progress, Skeleton)
  • 표시 구성 요소 (Table, Data Table, Avatar, Badge)

테마 및 사용자 정의

테마 구성, CSS 변수, 다크 모드 구현 및 구성 요소 사용자 정의입니다.

참고: references/shadcn-theming.md

다음 내용을 다룹니다:

  • next-themes를 사용한 다크 모드 설정
  • CSS 변수 시스템
  • 색상 사용자 정의 및 팔레트
  • 구성 요소 변형 사용자 정의
  • 테마 토글 구현

접근성 패턴

ARIA 패턴, 키보드 탐색, 스크린 리더 지원 및 접근성 구성 요소 사용입니다.

참고: references/shadcn-accessibility.md

다음 내용을 다룹니다:

  • Radix UI 접근성 기능
  • 키보드 탐색 패턴
  • 포커스 관리
  • 스크린 리더 알림
  • 양식 유효성 검사 접근성

Tailwind 유틸리티

레이아웃, 간격, 타이포그래피, 색상, 테두리 및 그림자를 위한 핵심 유틸리티 클래스입니다.

참고: references/tailwind-utilities.md

다음 내용을 다룹니다:

  • 레이아웃 유틸리티 (Flexbox, Grid, positioning)
  • 간격 시스템 (padding, margin, gap)
  • 타이포그래피 (글꼴 크기, 두께, 정렬, 줄 높이)
  • 색상 및 배경
  • 테두리 및 그림자
  • 사용자 정의 스타일링을 위한 임의 값

반응형 디자인

모바일 우선 중단점, 반응형 유틸리티 및 적응형 레이아웃입니다.

참고: references/tailwind-responsive.md

다음 내용을 다룹니다:

  • 모바일 우선 접근 방식
  • 중단점 시스템 (sm, md, lg, xl, 2xl)
  • 반응형 유틸리티 패턴
  • 컨테이너 쿼리
  • 최대 너비 쿼리
  • 사용자 정의 중단점

Tailwind 사용자 정의

설정 파일 구조, 사용자 정의 유틸리티, 플러그인 및 테마 확장입니다.

참고: references/tailwind-customization.md

다음 내용을 다룹니다:

  • 사용자 정의 토큰을 위한 @theme 지시어
  • 사용자 정의 색상 및 글꼴
  • 간격 및 중단점 확장
  • 사용자 정의 유틸리티 생성
  • 사용자 정의 변형
  • 레이어 구성 (@layer base, components, utilities)
  • 구성 요소 추출을 위한 Apply 지시어

비주얼 디자인 시스템

캔버스 기반 디자인 철학, 시각적 커뮤니케이션 원칙 및 정교한 구성입니다.

참고: references/canvas-design-system.md

다음 내용을 다룹니다:

  • 디자인 철학 접근 방식
  • 텍스트보다 시각적 커뮤니케이션
  • 체계적인 패턴 및 구성
  • 색상, 형태 및 공간 디자인
  • 최소한의 텍스트 통합
  • 박물관 수준의 실행
  • 다중 페이지 디자인 시스템

유틸리티 스크립트

구성 요소 설치 및 설정 생성을 위한 Python 자동화입니다.

shadcn_add.py

종속성 처리를 통해 shadcn/ui 구성 요소를 추가합니다:

python scripts/shadcn_add.py button card dialog

tailwind_config_gen.py

사용자 정의 테마로 tailwind.config.js를 생성합니다:

python scripts/tailwind_config_gen.py --colors brand:blue --fonts display:Inter

모범 사례

  1. 구성 요소 구성: 단순하고 구성 가능한 프리미티브로 복잡한 UI 구축
  2. 유틸리티 우선 스타일링: Tailwind 클래스를 직접 사용하고 진정한 반복이 있을 때만 구성 요소 추출
  3. 모바일 우선 반응형: 모바일 스타일로 시작하고 반응형 변형을 계층화
  4. 접근성 우선: Radix UI 프리미티브 활용, 포커스 상태 추가, 시맨틱 HTML 사용
  5. 디자인 토큰: 일관된 간격 척도, 색상 팔레트, 타이포그래피 시스템 사용
  6. 다크 모드 일관성: 모든 테마 요소에 다크 변형 적용
  7. 성능: 자동 CSS 제거 활용, 동적 클래스 이름 사용 피하기
  8. TypeScript: 더 나은 개발 경험을 위해 완전한 타입 안전성 사용
  9. 시각적 계층 구조: 구성이 시선을 안내하도록 하고, 의도적으로 간격과 색상 사용
  10. 전문적인 장인 정신: 모든 세부 사항이 중요합니다 - UI를 공예로 대하세요

참고 자료 탐색

구성 요소 라이브러리

  • references/shadcn-components.md - 전체 구성 요소 카탈로그
  • references/shadcn-theming.md - 테마 및 사용자 정의
  • references/shadcn-accessibility.md - 접근성 패턴

스타일링 시스템

  • references/tailwind-utilities.md - 핵심 유틸리티 클래스
  • references/tailwind-responsive.md - 반응형 디자인
  • references/tailwind-customization.md - 설정 및 확장

비주얼 디자인

  • references/canvas-design-system.md - 디자인 철학 및 캔버스 작업 흐름

자동화

  • scripts/shadcn_add.py - 구성 요소 설치
  • scripts/tailwind_config_gen.py - 설정 생성

일반 패턴

유효성 검사가 포함된 양식:

import { useForm } from "react-hook-form"
import { zodResolver } from "@hookform/resolvers/zod"
import * as z from "zod"
import { Form, FormField, FormItem, FormLabel, FormControl, FormMessage } from "@/components/ui/form"
import { Input } from "@/components/ui/input"
import { Button } from "@/components/ui/button"

const schema = z.object({
  email: z.string().email(),
  password: z.string().min(8)
})

export function LoginForm() {
  const form = useForm({
    resolver: zodResolver(schema),
    defaultValues: { email: "", password: "" }
  })

  return (
    <Form {...form}>
      <form onSubmit={form.handleSubmit(console.log)} className="space-y-6">
        <FormField control={form.control} name="email" render={({ field }) => (
          <FormItem>
            <FormLabel>Email</FormLabel>
            <FormControl>
              <Input type="email" {...field} />
            </FormControl>
            <FormMessage />
          </FormItem>
        )} />
        <Button type="submit" className="w-full">Sign In</Button>
      </form>
    </Form>
  )
}

다크 모드가 포함된 반응형 레이아웃:

<div className="min-h-screen bg-white dark:bg-gray-900">
  <div className="container mx-auto px-4 py-8">
    <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">
      <Card className="bg-white dark:bg-gray-800 border-gray-200 dark:border-gray-700">
        <CardContent className="p-6">
          <h3 className="text-xl font-semibold text-gray-900 dark:text-white">
            Content
          </h3>
        </CardContent>
      </Card>
    </div>
  </div>
</div>

리소스

Individual skills in this repo

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

tmnhutwork/Landingpage-Photo-Retouch

Run a WCAG 2.1 AA accessibility audit on a design or page. Trigger with "audit accessibility", "check a11y", "is this accessible?", or when reviewing a design for color contrast, keyboard navigation, touch target size, or screen reader behavior before handoff.

tmnhutwork/Landingpage-Photo-Retouch

Get structured design feedback on usability, hierarchy, and consistency. Trigger with "review this design", "critique this mockup", "what do you think of this screen?", or when sharing a Figma link or screenshot for feedback at any stage from exploration to final polish.

tmnhutwork/Landingpage-Photo-Retouch

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.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Synthesize user research into themes, insights, and recommendations. Use when you have interview transcripts, survey results, usability test notes, support tickets, or NPS responses that need to be distilled into patterns, user segments, and prioritized next steps.

tmnhutwork/Landingpage-Photo-Retouch

Plan, conduct, and synthesize user research. Trigger with "user research plan", "interview guide", "usability test", "survey design", "research questions", or when the user needs help with any aspect of understanding their users through research.

tmnhutwork/Landingpage-Photo-Retouch

Write or review UX copy — microcopy, error messages, empty states, CTAs. Trigger with "write copy for", "what should this button say?", "review this error message", or when naming a CTA, wording a confirmation dialog, filling an empty state, or writing onboarding text.

tmnhutwork/Landingpage-Photo-Retouch

Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter/X, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills.

tmnhutwork/Landingpage-Photo-Retouch

Brand voice, visual identity, messaging frameworks, asset management, brand consistency. Activate for branded content, tone of voice, marketing assets, brand compliance, style guides.

tmnhutwork/Landingpage-Photo-Retouch

Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG, Gemini 3.1 Pro), social photos (HTML→screenshot, multi-platform). Actions: design logo, create CIP, generate mockups, build slides, design banner, generate icon, create social photos, social media images, brand identity, design system. Platforms: Facebook, Twitter, LinkedIn, YouTube, Instagram, Pinterest, TikTok, Threads, Google Ads.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Translates Figma designs into production-ready application code with 1:1 visual fidelity. Use when implementing UI code from Figma files, when user mentions "implement design", "generate code", "implement component", provides Figma URLs, or asks to build components matching Figma specs. For Figma canvas writes via `use_figma`, use `figma-use`.

tmnhutwork/Landingpage-Photo-Retouch

Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.

tmnhutwork/Landingpage-Photo-Retouch

Create strategic HTML presentations with Chart.js, design tokens, responsive layouts, copywriting formulas, and contextual slide strategies.

tmnhutwork/Landingpage-Photo-Retouch

UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.

관련 스킬