Young Tries AI

Kubai Icons 스킬로 Claude Code가 같은 스타일의 움직이는 아이콘을 그리게 만들기

웹 디자인에서 일관된 스타일의 아이콘이 필요한 개발자와 크리에이터를 위한 중급 가이드입니다. 스킬 설치부터 아이콘 요청, React 패키지 사용까지 다룹니다.

웹·디자인대상: 개발자, 크리에이터

시작하기 전에

  • Claude Code(스킬 폴더 ~/.claude/skills) 또는 Codex(스킬 폴더 ~/.agents/skills)
  • 저장소를 복제할 git
  • 이미지를 읽을 수 있는 모델, 제작진은 Claude Opus 5.5를 권장
  • React 프로젝트에서 패키지를 쓸 때만 필요한 Node와 npm
  1. 스킬 폴더에 저장소를 clone하세요. Codex에서는 ~/.claude/skills 대신 ~/.agents/skills를 사용합니다. 다음 단계의 설치 프롬프트를 에이전트에 붙여 넣어도 됩니다.

    터미널에서 실행
    git clone https://github.com/kubai087/kubai-icons.git ~/.claude/skills/kubai-icons
  2. 직접 설치하기 싫다면 아래 내용을 에이전트에 붙여 넣어 보내세요. 올바른 스킬 폴더에 저장소를 복제하고, 이미 있으면 최신 버전을 받은 뒤 SKILL.md가 있는지 확인합니다.

    에이전트에 붙여넣기
    Install the Kubai Icons skill for me: clone https://github.com/kubai087/kubai-icons into your skills folder as kubai-icons (~/.claude/skills in Claude Code, ~/.agents/skills in Codex; if it's already there, pull the latest version instead), make sure SKILL.md exists in that folder, and tell me when it's ready.

    뜻: Kubai Icons 저장소를 스킬 폴더에 kubai-icons로 설치하고, 이미 있으면 최신 버전으로 갱신한 뒤 SKILL.md 존재를 확인해 알려 달라는 지시입니다.

  3. 스킬을 인식하도록 에이전트를 다시 시작하세요. 이 스킬은 정밀한 도형 작업과 자체 스크린샷 확인을 여러 차례 요구하므로 이미지를 읽는 모델이 필요합니다. Claude Code에서는 아래 명령으로 권장 모델을 지정해 시작할 수 있습니다.

    터미널에서 실행
    claude --model claude-opus-5-5
  4. 필요한 내용을 설명하세요. 아이콘 요청이면 스킬이 작동하므로 이름을 부를 필요가 없습니다. 에이전트는 기능마다 일상 사물과 호버 동작을 한 줄로 정하고, 가장 가까운 기존 아이콘을 본떠 그린 뒤, 기존 아이콘 옆에서 자체 점검을 체크리스트가 모두 통과할 때까지 반복합니다.

    Claude에 붙여넣기
    Read this repository and draw dynamic icons for its main features.

    뜻: 저장소를 읽고 주요 기능마다 움직이는 아이콘을 그려 달라는 요청입니다.

  5. 같은 스킬로 아이콘 추가와 정적 내보내기도 맡길 수 있습니다. README의 예시는 "Add a scissors icon and a map icon to this set.", "We need an icon for Export that matches the others." 등입니다. 자기 제품용 세트를 시작하면 엔진, 갤러리, 자체 점검을 프로젝트에 복사해 그곳에서 작업합니다.

    Claude에 붙여넣기
    Give me static SVG files I can drop into Figma.

    뜻: Figma에 바로 넣을 수 있는 정적 SVG 파일을 달라는 요청입니다.

  6. 완성된 아이콘만 필요하면 React 패키지를 설치하세요. React 18 이상과 서버 렌더링을 포함한 Next.js를 지원합니다. Vue 3.3 이상과 Nuxt, 순수 JavaScript(kubai-icons), 정적 SVG(kubai-icons-static) 패키지도 있습니다.

    터미널에서 실행
    npm install kubai-icons-react
  7. 아이콘은 PascalCase 이름으로 import하세요. 기본 크기는 24px이고 글자색을 따라가며, 문서에는 size={32}와 color="#EC4899" 같은 속성이 나옵니다. 라이브러리의 이름은 영어 kebab-case(cloud-rain), 코드에서는 PascalCase(CloudRain)입니다. icons.kubai.design에서 아이콘을 찾아 코드를 복사할 수 있습니다.

    React import
    import { Folder, MailPlus } from "kubai-icons-react";

주의할 점

  • 이미지를 읽을 수 있는 모델을 쓰세요. 스킬이 정밀한 도형 작업과 자체 스크린샷 확인을 여러 차례 거칩니다.
  • Codex의 스킬 폴더는 ~/.claude/skills가 아니라 ~/.agents/skills입니다.
  • 스킬을 지원하지 않는 에이전트도 복제한 폴더의 SKILL.md를 읽고 따라 할 수 있습니다.
  • 패키지에서 아이콘 이름을 바꾸거나 삭제하면 호환이 깨지지만, 다시 그리는 것은 아닙니다. 새 아이콘은 새 릴리스로 나옵니다.
  • CDN 링크의 @0은 최신 0.x 릴리스를 불러오며, 새 릴리스로 바뀌기까지 시간이 걸릴 수 있습니다.

자주 묻는 질문

어떤 에이전트에서 쓸 수 있나요?
Claude Code, Codex 등 코딩 에이전트에서 씁니다. Claude Opus 5.5로 개발하고 블라인드 테스트했으며 제작진이 권장하지만, Codex의 GPT 같은 다른 모델도 같은 스킬을 쓸 수 있습니다.
요청할 때 스킬 이름을 말해야 하나요?
아닙니다. 아이콘에 관한 요청이면 스킬이 작동하므로 필요한 내용을 평범한 말로 설명하면 충분합니다.
스킬 없이 아이콘을 둘러볼 방법이 있나요?
있습니다. icons.kubai.design에서 이름, 모양, 의미로 검색하고 색을 바꾸며, 코드나 에이전트용 프롬프트를 복사하고 SVG나 PNG로 받을 수 있습니다. 컬렉션은 ZIP으로 저장됩니다.
새로 추가된 아이콘은 어떻게 받나요?
프로젝트에 설치한 패키지를 업데이트하세요. React라면 npm install kubai-icons-react@latest를 실행합니다.
아이콘 라이선스는 무엇인가요?
README에 아이콘 라이브러리가 MIT 라이선스라고 적혀 있습니다.

출처

바탕이 된 소식