Community이미지github.com

make-perler-beads

사용자가 제공한 이미지나 텍스트 아이디어를 퍼러 비즈/열융합 비즈 작품으로 변환하여 정확한 비즈 결과물 이미지, 색상 번호가 표시된 시공 그리드, 색상 범례, 비즈 소요량 목록을 출력하고, 선택적으로 샤오홍슈 스타일의 전시 이미지를 생성합니다.

make-perler-beads란 무엇인가요?

이 스킬은 사용자가 업로드한 사진, 인물, 반려동물, 캐릭터, 로고, 아이콘, 스크린샷, 일러스트 등 모든 이미지를 퍼러 비즈(Perler), 하마(Hama), 아트칼(Artkal), 퓨즈 비즈, 픽셀 비즈 또는 비즈 패턴 스타일로 변환합니다. 원본 이미지의 특징을 최대한 살리면서도 실제 제작 가능한 시공 도면을 생성하는 것이 핵심입니다. 입력 이미지를 분석하여 적절한 그리드 크기, 색상 팔레트, 배경 처리 방식을 결정하고, Python Pillow 기반의 결정론적 스크립트를 실행하여 비즈 미리보기 이미지, 컬러 번호가 표시된 시공 그리드, 색상 범례, 재료 명세서(BOM)를 생성합니다. 선택적으로 생성된 결과물을 바탕으로 샤오홍슈 스타일의 제품 전시 이미지를 제작할 수 있으며, 모든 파일은 동일한 비즈 매트릭스에서 파생되어 정확성을 보장합니다. 주로 Codex, Cursor 등 이미지 처리와 Python 실행이 가능한 AI 에이전트 플랫폼에서 사용됩니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/billxfan/agent-skills/tree/HEAD/skills/make-perler-beads

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

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

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

미리보기

스킬 README에서

명확한 색상 미리보기
퍼러 비즈 결과물 이미지

문서

퍼러 비즈 패턴 생성기

이미지를 원본과 비슷하면서도 실제 제작 가능한 퍼러 비즈 도면으로 변환합니다. 먼저 무광 색상 미리보기에서 주요 대상을 명확히 확인할 수 있도록 한 후, 실제 비즈 표면을 표현합니다. 정확한 비즈 위치, 색상 번호 및 수량은 결정론적 스크립트로 계산해야 하며, 이미지 생성은 선택적인 분위기 전시 이미지에만 사용합니다.

요청 모드 판단

요청을 충족할 수 있는 최소한의 모드를 선택합니다.

  • 도면 모드 — 이미지가 있을 때 기본 사용: 원본 이미지 → 정확한 퍼러 비즈 결과물 이미지 + 번호가 매겨진 시공 그리드 + 색상 구성 및 소요량 파일.
  • 전시 모드: 먼저 도면 모드를 완료한 후, 결과물 이미지를 바탕으로 샤오홍슈 스타일의 평면 배치도 또는 제품 전시 이미지를 생성합니다. 생성형 전시 이미지를 시공 도면으로 사용해서는 안 됩니다.
  • 텍스트 디자인 모드: 사용자에게 이미지가 없고 텍스트 아이디어만 있을 때, 먼저 깔끔하고 주제가 집중된 원본 이미지를 생성한 후 도면 모드로 전환합니다.
  • 프롬프트 전용 모드: 사용자가 명시적으로 요청한 경우에만 사용하며, 프롬프트와 권장 매개변수를 반환하고 도면이 생성되었다고 주장하지 않아야 합니다.

사용자가 이미지를 업로드한 후 "퍼러 비즈로 만들어 줘"라고만 말하면 직접 도면 모드를 사용합니다. 안전하게 결정할 수 있는 매개변수는 사용자에게 되묻지 않습니다.

관련 가이드 읽기

  • 그리드 크기, 배경 처리, 색상 팔레트 또는 비즈 표면 스타일을 선택하기 전에 references/design-guide.md를 읽습니다.
  • 반환물을 출력하기 전에 references/quality-gate.md를 읽고 검사를 완료합니다.

입력 규칙

  1. 변환 전에 실제 원본 이미지를 확인하고, 크기, 가로세로비, 주요 대상, 배경 복잡도, 투명 영역 및 중요한 텍스트나 식별 특징을 기록합니다.
  2. 사용자가 이미지를 스타일 참고용으로만 사용한다고 명시하지 않는 한, 주요 대상을 유지해야 하는 편집 대상으로 간주합니다.
  3. 그리드 용량이 허용되는 범위 내에서, 보이는 식별 특징, 외곽선, 방향, 객체 수, 주요 색상 블록 및 필요한 짧은 텍스트를 유지합니다.
  4. 그리드가 너무 작아 얼굴, 작은 글자, 복잡한 장면 또는 미세한 마크를 수용할 수 없는 경우, 제한 사항을 간결하게 설명하고 그리드 크기를 늘리며, 세부 사항을 허위로 생성하지 않습니다.
  5. 의미 있는 배경을 함부로 제거해서는 안 됩니다. 배경이 거의 단색이거나 사용자가 명시적으로 피사체만 분리하도록 요청한 경우에만 자동 배경 제거를 사용합니다.
  6. 여러 인물이나 복잡한 장면의 경우 먼저 "선명도 예산"을 계산합니다. 각 핵심 피사체에 할당될 수 있는 비즈 셀 수를 추정합니다. 핵심 얼굴, 반려동물 머리 또는 로고의 너비가 약 16셀 미만이면, 직접 생성하는 대신 피사체를 더 좁게 자르거나 그리드를 높이는 것을 우선시합니다.

도면 모드流程

  1. 로컬 이미지 보기 기능을 사용하여 원본 이미지를 확인하고 파일 크기를 읽습니다.
  2. references/design-guide.md에 따라 그리드 크기, 색상 팔레트, 맞춤 방식, 배경 처리 및 비즈 표면 스타일을 선택합니다.
  3. Pillow가 설치된 Python 환경을 찾습니다. Codex 데스크톱에서는 먼저 워크스페이스 종속성을 로드한 후, 반환된 내장 Python 경로를 사용합니다. Pillow가 없으면 종속성 누락을 설명하고, 허가 없이 직접 설치하지 않습니다.
  4. 다음 명령어를 실행합니다:
<Pillow-포함-Python> scripts/render_bead_pattern.py 입력_이미지 출력_디렉토리 \
  --width-beads 48 \
  --max-colors 18 \
  --fit contain \
  --background keep \
  --render beads

이 Skill 디렉토리에서 스크립트와 리소스 경로를 분석합니다. --help를 사용하여 모든 매개변수를 확인합니다. 복잡한 일러스트의 경우 --sharpen 1.2를 추가하고, 주요 대상에 초점을 맞춰야 할 때는 --crop "left,top,right,bottom"을 사용하며, 작은 영역의 주요 색상을 고정해야 할 때는 따옴표로 묶인 --anchor-colors "#F2C76E,#8A315F"를 사용합니다. 원본 이미지에서 적응형 색상 팔레트를 추출해야 할 때는 --palette source를 사용하고, 사용자의 재고 또는 브랜드 팔레트를 사용해야 할 때는 assets/generic-palette.json과 동일한 구조의 JSON을 전달합니다.

  1. 먼저 무광 색상 미리보기를 보고 구도와 주요 대상이 명확한지 판단한 후, 비즈 결과물 이미지와 시공 그리드를 확인합니다. 명령 출력에만 의존하지 않습니다.
  2. 원본 크기와 축소 크기에서 각각 원본 이미지와 비교합니다. 식별 특징이나 윤곽선이 손실된 경우, 피사체를 더 좁게 자르거나 그리드를 높이는 것을 우선시하고, 가는 선이 손실된 경우 선명도를 높이며, 주요 색상이 사라진 경우 주요 색상을 고정합니다. 한 번 재시도합니다.
  3. 소요량 표의 합계가 모든 비어 있지 않은 셀의 수와 일치하는지 확인합니다.

스크립트는 다음 파일을 출력합니다:

  • *-color-preview.png: 구멍이나 레이블이 없는 명확한 색상 미리보기로, 피사체의 식별 가능성을 판단하는 데 사용됩니다.
  • *-bead-preview.png: 정확한 그리드로 렌더링된 퍼러 비즈 결과물 이미지.
  • *-pattern.png: 색상 번호가 표시된 시공 그리드.
  • *-legend.png: 색상 범례 및 각 색상의 수량.
  • *-pattern.csv: 셀별 색상 번호 테이블.
  • *-bom.csv: 재료 명세서.
  • *-metadata.json: 변환 매개변수, 색상 및 총 개수.

전시 모드流程

먼저 도면 모드를 완료한 후, 생성된 퍼러 비즈 결과물 이미지를 내장 이미지 생성 기능의 편집 대상으로 전달합니다.

디자인, 그리드 비율, 윤곽선, 방향 및 주요 색상 위치를 변경하지 않고 유지합니다. 촬영 각도, 베이스 재질, 테이블, 조명, 소품 및 배경만 변경할 수 있습니다. 깔끔한 탑뷰 수작업 테이블, 부드러운 자연광 및 약간의 관련 도구를 우선적으로 사용하며, 손이나 소품이 작품을 가리지 않도록 합니다.

전시 이미지가 디자인이나 비즈 위치를 명백히 변경한 경우, 더 엄격한 유지 조건으로 한 번 재시도합니다. 먼저 정확한 결과물 이미지와 시공 파일을 반환한 후 전시 이미지를 반환하여 혼동을 방지합니다.

텍스트 디자인 모드流程

  1. 사용자 요청을 중앙에 배치되고 식별 가능한 윤곽선 또는 간결한 구도로 수렴합니다.
  2. 배경이 순수하거나 투명하고, 색상 블록이 넓으며, 텍스처나 조명 그라데이션, 작은 글자가 없는 원본 이미지를 생성합니다.
  3. 실제 생성된 이미지를 도면 모드로 전달합니다.
  4. 이것은 텍스트를 기반으로 디자인된 것이며 사용자의 원본 이미지를 변환한 것이 아님을 명확히 설명합니다.

반환 형식

가장 실용적인 결과물을 우선적으로 반환합니다.

**명확한 패턴 미리보기**

![명확한 색상 미리보기](색상_미리보기_절대_경로)

**퍼러 비즈 결과물 이미지**

![퍼러 비즈 결과물 이미지](결과물_이미지_절대_경로)

**시공도 및 소요량**

- 그리드: [너비] × [높이]
- 색상: [색상 수]
- 총 비즈 수: [비어 있지 않은 셀 수]
- 시공 그리드: [클릭 가능한 절대 경로]
- 색상 번호 범례: [클릭 가능한 절대 경로]
- 소요량 표: [클릭 가능한 절대 경로]

**변환 설정**

- [그리드 / 색상 팔레트 / 맞춤 / 배경 / 비즈 표면 스타일]
- [유지된 효과나 필요한 절충에 대한 한 줄 설명]

전시 모드를 실행한 경우에만 전시 이미지를 추가로 포함합니다. 사용자가 요청하지 않는 한 내부 로그나 전체 메타데이터 JSON을 출력하지 않습니다.

필수 규칙

  • 결과물 이미지, 시공 그리드, CSV, 범례 및 소요량은 모두 동일한 비즈 매트릭스에서 파생되어야 합니다.
  • 무광 색상 미리보기와 비즈 결과물 이미지도 동일한 비즈 매트릭스에서 파생되어야 하며, "더 예쁜" 다른 이미지를 명확한 미리보기로 사용해서는 안 됩니다.
  • 생성형 이미지를 정확한 비즈 수가 있는 시공 도면으로 절대 사용해서는 안 됩니다.
  • 범용 색상 팔레트 번호를 Perler, Hama, Artkal 또는 다른 제조업체의 공식 색상 번호라고 절대 주장해서는 안 됩니다.
  • 사용자가 제조업체 색상표를 제공하는 경우, 이를 데이터로 사용하고 출처를 정확히 표시합니다.
  • 작은 크기의 패턴에는 긴 텍스트를 배치하지 말고, 대신 이니셜, 짧은 단어 또는 더 큰 그리드를 사용합니다.
  • 저해상도 PNG를 확대하는 것은 재현도를 높이는 것이 아닙니다. 반드시 비즈 셀 수를 늘리고 다시 계산해야 합니다.
  • 두 개의 핵심 피사체가 색상 미리보기의 축소 이미지에서 여전히 식별되지 않는 경우, 결과를 "명확함" 또는 "완전히 재현됨"이라고 설명해서는 안 됩니다.

호출 예시

  • "$make-perler-beads를 사용하여 이 고양이 사진을 48셀 너비의 퍼러 비즈 도면으로 만들어 줘."
  • "인물만 남기고 배경을 제거하고, 색상을 16가지 이내로 제한해 줘."
  • "이 로고를 29×29 퍼러 비즈로 만들고 시공 그리드와 소요량 표를 제공해 줘."
  • "퍼러 비즈 도면 완료 후, 샤오홍슈 스타일의 테이블 전시 이미지를 생성해 줘."

관련 스킬