🎨 AI 에이전트에게 취향을 이식하는 법 — 스킬 파일이 답이다

AI가 만든 UI, 왜 어딘가 어색할까요?

요즘 AI 코딩 에이전트를 실무에 쓰다 보면 이런 경험 한 번씩은 해보셨을 거예요. 로직은 완벽하게 돌아가는데, 버튼 하나가 어딘가 어색하고, 팝업 하나가 왠지 어설프게 느껴지는 그 순간. 이건 AI가 멍청해서가 아닙니다. 단지 "좋은 UI가 어떤 느낌인지"를 AI가 모르기 때문이에요.

Cursor, Claude Code, GitHub Copilot 같은 에이전트들은 이제 코드 작성, 디버깅, 심지어 전체 앱 설계까지 함께 할 수 있게 됐습니다. 그런데 "이 애니메이션이 자연스러운가", "이 버튼의 클릭감이 적절한가" 같은 감각적 판단은 여전히 취약하죠.

이 문제를 정면으로 다룬 글이 있어요. 디자인 엔지니어 에밀 코왈스키(Emil Kowalski)가 쓴 '취향을 가진 에이전트(Agents with Taste)'라는 아티클인데, 핵심 메시지가 단순하고 강렬합니다. "당신의 취향을 언어로 만들어 에이전트에게 먹여라."

오늘은 이 개념을 바탕으로 스킬 파일이 무엇인지, 어떻게 만들고, 실무에서 어떻게 써먹는지 풀어볼게요.

스킬 파일이 대체 뭔가요?

스킬 파일은 특정 작업 영역에 대한 규칙, 원칙, 판단 기준을 정리한 마크다운 문서입니다. 쉽게 말하면 AI 에이전트를 위한 작업 매뉴얼이에요. "이런 상황에서는 이렇게 처리해라"는 기준을 문서로 만들어 에이전트에게 먹이는 방식이죠.

Anthropic이 공개한 에이전트 스킬 오픈 표준에 따르면, 스킬은 프롬프트 엔지니어링이나 RAG보다 훨씬 유연한 방식입니다. 에이전트가 파일 시스템을 탐색하고 코드를 실행할 수 있어서, 기존 컨텍스트 창의 한계를 넘어 훨씬 더 많은 전문 지식을 활용할 수 있거든요. 더 중요한 건, 에이전트가 처음에는 스킬의 이름과 설명만 알고 있다가, 필요할 때 관련 정보를 불러오는 '점진적 공개(Progressive Disclosure)' 방식으로 동작한다는 점이에요. 컨텍스트 낭비를 줄이면서도 필요한 순간에 딱 꺼내 쓸 수 있습니다.

취향에는 반드시 '이유'가 있습니다

에밀의 글에서 가장 인상적인 부분은 "좋은 취향은 언어화할 수 있다"는 주장이에요. 예를 들어볼게요.

팝업 요소가 화면에 등장할 때, scale(0)에서 시작하면 어색하고, scale(0.95)에서 시작하면 자연스럽습니다. 왜냐고요? 실제 세계에서 물체는 완전히 사라졌다가 나타나지 않기 때문이에요. 풍선도 바람을 완전히 빼도 형태가 남아 있는 것처럼요. 이게 바로 취향의 이유입니다.

이런 이유가 정리되면 에이전트에게 그대로 전달할 수 있어요. 에이전트는 그 규칙을 충실히 따릅니다. 마치 경험 많은 선배 디자이너가 신입에게 설명해주는 것처럼요.

애니메이션 이징 선택을 예로 들면, 요소가 화면 안으로 들어올 때는 ease-out, 화면 위에서 이동하거나 변형될 때는 ease-in-out, 호버 상태 변화에는 ease, 지속적인 움직임에는 linear를 사용합니다. AI가 이제 느낌으로 추측하지 않아도 되는 거예요. 그냥 따르면 됩니다.

지속 시간 규칙도 마찬가지예요. 마이크로 인터랙션은 100~150밀리초, 툴팁이나 드롭다운 같은 표준 UI는 150~250밀리초, 모달이나 드로어는 200~300밀리초. 300밀리초를 넘기지 말 것, 사라지는 애니메이션은 등장보다 약 20% 빠르게 할 것. 이런 규칙들이 문서 하나에 담기면, 에이전트는 어떤 요소를 만들든 일관된 감각으로 처리합니다.

스킬 파일은 어떻게 생겼나요? 구조부터 보겠습니다

스킬 파일은 SKILL.md 파일을 중심으로 한 디렉토리 구조를 사용합니다. 실행 스크립트(scripts/)와 참조 문서(references/)를 분리해서 체계적으로 관리하는 방식이에요.

가장 중요한 것은 SKILL.md 본문인데, 여기에는 이런 내용들이 들어갑니다. 언제 이 스킬을 써야 하는지 트리거 조건, 작업 순서와 규칙, 판단 기준과 예시, 절대 하면 안 되는 것들이죠.

마크다운 본문 길이는 가급적 500줄 이하로 유지하는 게 좋습니다. 방대한 API 명세서나 코드는 본문에 직접 넣지 말고 references 디렉토리에 분리한 뒤, 본문에서는 파일의 상대 경로만 참조하도록 작성하는 게 핵심이에요. 에이전트가 필요한 순간에만 해당 파일을 로드해서 컨텍스트 토큰 소비를 극적으로 줄여줍니다.

스킬 파일이 단순한 프롬프트와 다른 이유

기존 커스텀 명령어 방식은 사용자가 항상 수동으로 호출해야 했고, 실행될 때마다 전체 프롬프트가 한 번에 로드돼서 컨텍스트를 낭비했어요.

스킬 파일은 다릅니다. 사용자의 의도를 파악해 0.1초 만에 알아서 스킬을 활성화하는 자동 호출 기능이 도입됐고, 필요한 순간에만 문서를 읽어들이는 점진적 정보 노출 메커니즘으로 토큰 소비를 크게 줄였습니다. 예를 들어 워드 문서 작성, 파워포인트 보고서 제작, 브랜드 가이드라인 준수 같은 특정 업무를 에이전트가 자동으로 수행하도록 구성할 수 있어요.

OpenAI Codex 팀의 실험을 보면 이게 얼마나 강력한지 알 수 있습니다. 2025년 8월부터 약 5개월간 진행된 실험에서 팀은 수동으로 작성된 코드 없이 AI가 생성한 약 백만 개 라인의 프로덕션 코드를 완성했어요. 엔지니어 1인당 하루 평균 3.5개의 풀 리퀘스트를 머지했고, 수동 개발 대비 약 10배의 속도를 달성했습니다. 핵심은 에이전트를 잘 만든 게 아니라, 에이전트가 일할 수 있는 환경, 즉 스킬과 규칙과 제약을 잘 설계한 것이었어요.

취향을 언어로 만드는 능력이 핵심 경쟁력입니다

Figma의 2025년 AI 리포트에 따르면 응답자의 78%가 "AI 통합은 미래 성공의 필수 요소"라고 답했다고 해요. 그런데 AI를 쓰는 것과 잘 쓰는 것은 전혀 다른 이야기입니다.

AI가 더 강력해질수록 개인의 취향과 판단력이 오히려 더 중요해지는 역설이 생겨요. 에이전트는 기술적 완성도를 높여주지만, 무엇을 만들지, 어떤 느낌으로 만들지는 여전히 사람이 정해야 하거든요.

내가 왜 이 버튼에 이 패딩을 줬는지, 왜 이 색이 이 맥락에 어울리는지를 언어로 설명할 수 있어야 합니다. 설명할 수 있으면 문서화할 수 있고, 문서화하면 에이전트에게 이식할 수 있어요. 이게 바로 스킬 파일의 본질입니다.

B2B 제품에서 스킬 파일은 더 강력합니다

범용 디자인 원칙보다 자기 제품에 맞는 취향 규칙이 훨씬 값집니다. 특히 B2B 제품에서요.

헬스케어 CRM이나 보험 플랫폼처럼 신뢰가 핵심인 제품이라면, 예를 들어 이런 규칙들이 실용적이에요. "색상은 과감함보다 안정감을 우선한다", "오류 메시지는 사용자를 탓하지 않는 어투로 작성한다", "CTA 버튼은 1개를 초과하지 않는다". 이런 규칙들이 스킬 파일에 담기면, 어떤 화면을 만들든 제품의 톤앤매너가 일관되게 유지됩니다.

일본의 라쿠텐은 스킬을 도입해 재무 관리 자동화를 이미 진행 중인데요, 여러 스프레드시트를 분석해 이상치를 잡아내고 보고서를 생성하는 작업이 기존 하루 걸리던 작업을 한 시간 만에 끝낸다고 합니다. 단순한 자동화가 아니라 "어떻게 분석하고 어떤 형식으로 보고할지"가 스킬에 담겨 있기 때문에 가능한 일이에요.

어디서부터 시작할까요? 아주 작게 시작하세요

처음 스킬 파일을 만드는 분들에게 드리는 말씀은 간단합니다. 지금 당장 완벽하게 만들 필요 없어요.

매번 UI를 수정하거나 문서를 작성할 때마다 자신에게 물어보세요. "왜 이게 더 나아 보이지?" 그 대답을 메모해두면, 그게 곧 스킬 파일의 초안이 됩니다. 처음에는 5줄짜리 규칙 목록이어도 충분해요. 타이포그래피부터 시작해도 좋고, 오류 메시지 어투 규칙부터 시작해도 좋습니다.

특정 도메인에 집중된 규칙일수록 오히려 더 강력합니다. 범용 디자인 원칙을 가져다 붙이는 것보다, "우리 제품에서는 이렇게 한다"는 규칙이 에이전트를 훨씬 더 정확하게 만들어줘요.

마무리

AI 에이전트 시대에 중요한 것은 어떤 툴을 쓰느냐가 아니라, 그 툴에 무엇을 먹이느냐입니다. 취향은 감각이 아니라 언어입니다.

지금 당장 자신이 UI를 고칠 때마다, 문서를 수정할 때마다 "왜?"라고 묻는 습관을 시작해보세요. 그 답들이 쌓이면 당신만의 스킬 파일이 됩니다. 그리고 그 파일이 에이전트의 기준이 되고, 에이전트는 평범한 코더에서 취향 있는 동료로 바뀝니다.

AI가 더 똑똑해질수록, 당신의 취향을 언어로 만드는 능력이 진짜 경쟁력이 됩니다.