[Claude Code 스킬] frontend-design, 템플릿처럼 보이지 않게 화면 만들기
프롬프트 한 줄로 만든 화면은 어디서 본 듯한 모양이 되기 쉽습니다. 이런 기본값을 피하도록 돕는 스킬의 원문을 읽으며 무엇을 하라고 하는지 정리하고, 이 블로그에서 디자인 기준을 지킨 방법과 비교했습니다.
AI에게 화면을 맡기면 흰 배경에 둥근 카드, 파란 버튼, 제목 위에 대문자 작은 글씨가 나옵니다. 틀린 건 아닌데 어느 사이트인지 구분이 안 됩니다. 카드마다 같은 둥근 모서리와 같은 회색 그림자가 붙고, 섹션이 바뀔 때마다 아래에서 부드럽게 올라오는 효과가 들어갑니다. 한두 번은 괜찮은데 같은 모양을 여러 번 보면 "AI가 만들었구나" 하는 느낌이 먼저 옵니다.
이 글에서는 이런 기본값을 피하도록 돕는 frontend-design 스킬을 다룹니다. 스킬 원문을 읽으며 어떤 순서로 일하라고 하는지, 무엇을 기본값이라고 부르는지 정리했습니다. 그다음 이 블로그가 디자인 기준을 어떻게 코드로 묶어 두었는지와 비교합니다. 화면을 AI에게 자주 맡기고, 결과가 늘 비슷해 보여서 고민이던 프론트엔드 개발자를 염두에 두었습니다.
1. 어떤 스킬인가
Claude Code용 example-skills 플러그인에 들어 있는 스킬입니다. 스킬 파일 맨 위의 설명(description)은 새 UI를 만들거나 기존 UI를 바꿀 때 미적 방향과 타이포그래피를 정하고, 템플릿 같은 기본값으로 읽히지 않는 선택을 하도록 돕는다고 적고 있습니다.
name: frontend-design
description: Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.본문은 에이전트에게 역할을 먼저 줍니다. 모든 고객에게 서로 다른 시각적 정체성을 주는 디자인 스튜디오의 디자인 리드처럼 접근하라는 것입니다. 이 고객은 이미 상투적이거나 템플릿 같은 제안을 거절한 적이 있다는 설정도 붙습니다. 그래서 팔레트, 글꼴, 레이아웃에서 이 요청에만 맞는 의도된 선택을 하고, 필요하면 모험도 하라고 합니다. 코드 생성 도구에 디자이너의 관점을 빌려 주는 방식입니다.
주제에서 출발하기
스킬이 가장 먼저 요구하는 것은 만들려는 대상이 무엇인지 확인하는 일입니다. 요청에 제품이나 주제가 없으면 스스로 하나를 정해 고객에게 확인합니다. 구체적인 주제, 독자, 화면의 가장 큰 역할을 제안하는 식입니다. 원문은 업종, 소재, 그 분야에서 쓰는 말투에서 독특한 시각적 선택이 나온다고 설명합니다. 8세에서 11세 여자아이 장난감 화면과 금융 분석가용 대시보드가 같은 모양일 수 없다는 예가 실려 있습니다.
타이포그래피와 구조
글꼴은 페이지의 성격을 가장 크게 좌우한다고 봅니다. 제목용과 본문용을 꼭 다르게 쓸 필요는 없고, 한 가족이나 두 가족을 쓰되 두 개라면 확실히 다르게 고르라고 합니다. 늘 쓰던 기본 글꼴을 고르지 말고 이 요청에 맞는 글꼴을 고르라는 말도 있습니다. 한 줄은 80자 안쪽으로 두고, 세리프 본문에는 줄 간격을 조금 더 주라는 구체적인 수치도 있습니다.
생성된 화면의 흔한 티로 꼽는 처리도 적혀 있습니다. 제목에서 한 단어만 기울이거나 색을 바꾸는 것, 라벨을 전부 대문자로 쓰는 것, 내용 위에 필요 없는 라벨을 붙이는 것입니다. 번호 표시(01, 02, 03)는 내용이 실제로 순서가 있는 단계일 때만 쓰라고 합니다. 테두리, 번호, 구분선 같은 구조 장치는 장식이 아니라 내용에 대한 정보를 담아야 한다는 것이 이 대목의 논리입니다.
움직임은 아껴 쓰라고 합니다. 페이지가 열릴 때 한 번 일어나는 연출 하나가 섹션마다 흩어진 효과보다 낫고, 섹션마다 아래에서 올라오는 등장과 모든 카드에 붙인 호버 효과는 오히려 AI가 만든 티가 난다고 적혀 있습니다. 사용자의 동작에 답하는 움직임(열림, 펼침, 확인)은 무엇이 바뀌었는지 보여 주므로 환영한다고 합니다.
2. 출처
| 항목 | 내용 |
|---|---|
| AI 도구 | Claude Code |
| 종류 | 스킬 (example-skills 플러그인에 포함) |
| 만든 곳 | Anthropic |
| 저장소 | https://github.com/anthropics/skills |
| 설치 경로 | anthropics/skills 마켓플레이스(anthropic-agent-skills) |
| 확인한 버전 | 저장소 커밋 683bc88e56f3 (2026년 10월 7일 설치본 기준) |
| 라이선스 | Apache License 2.0 (스킬 폴더의 LICENSE.txt) |
3. 언제 쓰면 좋은가
랜딩, 소개, 로그인처럼 첫인상이 중요한 화면에 어울립니다. 이미 디자인 기준이 있는데 새 화면이 따로 노는 것 같을 때도 씁니다. 반대로 관리자 도구나 폼처럼 정보가 중심인 화면에서는 "독특한 정체성"이 오히려 방해가 될 수 있어서, 기준을 따르게 하는 쪽이 낫습니다.
4. 사용법
화면을 요청할 때 "이 프로젝트의 디자인 기준을 먼저 읽고, 템플릿 같지 않게"라고 덧붙입니다. 스킬이 켜지면 에이전트는 바로 코드를 쓰지 않고 두 번에 나누어 일합니다.
첫 번째 패스: 짧은 설계 계획
고객의 요청을 바탕으로 작은 토큰 체계를 먼저 만듭니다. 원문이 요구하는 항목은 네 가지입니다.
- 색: 기본 팔레트를 이름이 붙은 4~6개의 헥스(hex) 값으로 적습니다.
- 글꼴: 어떤 글꼴을 어떤 역할로 쓰는지 적습니다.
- 레이아웃: 한 문장 설명과 ASCII 와이어프레임으로 구상하고 비교하며, 정렬 방침(왼쪽, 가운데, 양쪽)도 밝힙니다.
- 원칙: 이 페이지를 특별하게 만드는 큰 방향을 적습니다.
두 번째 패스: 계획을 요청에 비춰 점검
그다음에 코드를 쓰는 것이 아니라, 방금 만든 계획이 어디서나 만들 법한 기본값은 아닌지 검토합니다. 비슷한 요청을 하나 더 떠올려서 같은 곳에 도달하는지 보라는 방법도 적혀 있습니다. 기본값처럼 보이는 부분이 있으면 고치고, 무엇을 왜 바꿨는지 말합니다. 이 검토를 통과한 뒤에야 코드를 씁니다. 코드를 쓸 때는 CSS 선택자의 우선순위가 서로를 지워 버리지 않게 조심하라는 주의도 있습니다.
스킬이 직접 꼽는 기본값 목록
원문에는 지금 AI가 만든 디자인이 몰리는 모양이 다섯 가지로 적혀 있습니다. 따뜻한 크림색 배경에 굵은 세리프 제목과 테라코타 포인트색, 거의 검은 배경에 한 가지 형광 포인트색, 신문 지면 같은 가는 선과 모서리가 각진 빽빽한 열, 똑같은 둥근 카드와 똑같은 회색 그림자로 내용을 자른 SaaS 카드 모음, 그리고 주제와 상관없이 따라붙는 템플릿 장식입니다. 마지막 항목은 구체적입니다. 모든 제목 위에 자간을 넓힌 대문자 라벨, 가운뎃점으로 이은 메타 정보, 공백을 둔 긴 줄표로 만든 라벨, 순수한 검정 대신 쓰는 짙은 회색, 작은 데이터 라벨의 고정폭 글꼴, 링크와 버튼 끝에 붙인 화살표입니다.
원문은 이 모두가 어떤 요청에는 정당한 선택일 수 있지만 "기본값이지 선택이 아니다"라고 말합니다. 요청이 시각 방향을 정해 두었다면 그대로 따르고, 열어 둔 축에서만 이 기본값들을 피하라는 것입니다. 이 블로그의 글쓰기 지침이 긴 줄표, 화살표, 가운뎃점을 금지하는 것과 같은 방향이라는 점이 눈에 띄었습니다.
마지막은 절제
스킬은 대담함을 한 곳에만 쓰라고 합니다. 기억에 남을 요소 하나를 정하고 나머지는 조용하게 둡니다. 모바일 대응, 보이는 키보드 포커스, 줄인 움직임 설정 존중, 접근성 같은 바닥 품질은 내세우지 않고 지킵니다. 환경이 허락하면 스크린샷으로 결과를 직접 검토하라는 말도 있습니다.
5. 적용 예시
이 스킬이 말하는 "기본값 대신 의도된 선택"을, 이 블로그에서는 기준 문서와 토큰으로 대신했습니다. 기준이 코드에 이미 있다면 에이전트가 새로 정할 것이 줄어들기 때문입니다. 아래는 이 블로그의 기준입니다.
@utility brutal {
border: 2px solid var(--ink);
border-radius: 6px;
background: var(--bg);
box-shadow: var(--shadow);
}
@utility btn-primary {
@apply btn bg-accent text-on-accent;
}
@utility chip {
@apply inline-flex cursor-pointer items-center rounded-full px-3 py-1 text-sm transition-colors hover:bg-bg-subtle;
border: 2px solid var(--ink);
}brutal은 굵은 테두리와 단단한 그림자의 카드, btn-primary는 포인트색 버튼, chip은 알약 모양 표시입니다. 이 셋과 globals.css의 색 변수가 이 블로그의 시각 언어입니다. 기획 단계의 STORYBOARD.md에는 사이트맵과 확정된 결정(스택, 테마, 댓글 방식)이 적혀 있고, 화면을 요청할 때는 이 두 곳을 읽게 합니다.
이 기준을 적용해 관리자 로그인 화면을 다듬은 변경입니다.
| 이전 | 이후 | |
|---|---|---|
| 카드 | 기본 테두리 상자 | 블로그 공통 brutal 카드 |
| 정체 | 제목 "Admin" 하나 | 자물쇠 아이콘, "관리자 전용" 칩, 안내 문구 |
| 출구 | 없음 | "블로그로 돌아가기" 링크 |
새 색이나 새 스타일을 하나도 만들지 않고 이미 있는 토큰만 조합했습니다. 화면의 핵심 코드는 아래와 같습니다.
<form onSubmit={onSubmit} className="brutal flex w-full max-w-sm flex-col gap-3 p-8">
<div className="mb-2 flex items-center gap-2">
<Lock className="size-5" aria-hidden />
<h1 className="text-xl font-semibold">Admin</h1>
<span className="chip ml-auto">관리자 전용</span>
</div>
<p className="mb-2 text-sm text-muted">블로그 주인만 로그인할 수 있습니다. 댓글을 남기려는 방문자는 글 아래의 GitHub 로그인을 이용해 주세요.</p>
<button type="submit" disabled={pending} className="btn-primary mt-2 w-full">{pending ? "..." : "Sign in"}</button>
</form>정체성을 더한 것은 자물쇠 아이콘과 칩, 안내 문구뿐입니다. 안내 문구는 장식이 아니라 댓글을 남기려는 방문자가 잘못 들어왔을 때 갈 곳을 알려 주는 정보입니다. 스킬이 말한 "구조 장치는 정보를 담아야 한다"는 원칙과 맞닿는 부분입니다.
6. 써 본 소감
디자인 스킬은 새로 꾸미게 하는 것보다 기존 기준을 잘 따르게 하는 쪽에서 값어치가 큽니다. 기준 문서가 있는 프로젝트에서는 스킬과 함께 그 문서를 같이 읽게 하는 편이 낫다고 생각합니다. 스킬이 말하는 기본값 목록은 디자인을 점검하는 체크리스트로도 쓸 만했습니다. 내 화면이 카드를 똑같이 잘라 놓았는지, 제목 위에 필요 없는 라벨을 얹었는지 훑어보는 용도입니다.
다만 이 스킬은 원래 "이 고객은 템플릿을 싫어한다"는 설정으로 대담한 선택을 끌어내는 쪽에 가깝습니다. 이미 시각 언어가 정해진 프로젝트에서는 이 대담함이 오히려 기준과 어긋날 수 있어서, 스킬의 지시보다 프로젝트의 기준이 우선하도록 순서를 잡아 주는 것이 필요했습니다.
Comments (0)