Ecommerce Image Skills란?
Ecommerce Image Skills는 일반 제품 사진을 플랫폼에 바로 사용할 수 있는 이커머스 그래픽으로 변환하는 설치 가능한 Agent Skills 12개의 모음입니다. 이 스킬은 SKILL.md 파일을 읽을 수 있는 Claude Code, Codex, Cursor 또는 다른 에이전트에서 사용할 수 있습니다.
서로 연결되지 않은 프롬프트를 대량으로 관리하는 대신, 각 스킬은 제품 식별 정보 지침, 플랫폼 사양, 모델 라우팅, 결정론적 이미지 처리 작업을 위한 선택적 스크립트를 하나로 결합합니다. Amazon 메인 이미지, 라이프스타일 장면, 인포그래픽, A+ 모듈, 사이즈 차트, 모델 착용 이미지, 세일 배너, 샤오홍슈 커버, 타오바오 상세 페이지를 만들 수 있습니다.
이 저장소는 GPT Image 2.5 모델을 지원합니다. gpt-image-2.5-flare는 빠른 장면 및 레이아웃 생성에 사용하고, 텍스트, 로고, 라벨 또는 국소 편집에 더 세심한 처리가 필요할 때는 gpt-image-2.5-sunburst를 사용합니다.
주요 기능
- 제품 식별 정보 고정: 각 스킬은 먼저 제품의 형태, 색상, 로고, 텍스트를 기록한 다음 생성 프롬프트에 해당 정보를 반영합니다.
- 내장 플랫폼 사양: Amazon의 흰색
#FFFFFF배경과 최소 제품 노출 비율, 750픽셀 타오바오 상세 페이지, 3:4 샤오홍슈 커버, A+ 모듈 크기, 플랫폼 배너 형식 등이 포함됩니다. - 모델 라우팅: Flare는 장면, 배경, 레이아웃 및 빠른 변형 생성에 기본 사용됩니다. 로고, 작은 텍스트, 최종 메인 이미지 및 국소 편집에는 Sunburst를 권장합니다.
- 결정론적 스크립트: 포함된 스크립트로 흰색 배경을 확인하고 수정하며, A+ 이미지를 자르고, 그리드를 만들고, 긴 상세 이미지를 이어 붙이거나 분할할 수 있습니다. 재시도, 재개, 로그 및 예산 제한을 지원하는 일괄 처리도 가능합니다.
- 세 가지 생성 방식: 에이전트의 내장 이미지 도구를 사용하거나, OpenAI 호환 API를 연결하거나, 최종 프롬프트를 생성한 뒤 제공된 온라인 워크플로를 사용할 수 있습니다.
사용 가능한 스킬
이 저장소에는 독립적으로 사용할 수 있는 스킬 12개가 포함되어 있습니다. 전체 모음을 설치하거나 필요한 폴더만 복사할 수 있습니다.
amazon-white-background는 순백색 배경, 텍스트 없음, 제품 노출 비율 검사를 적용한 Amazon 메인 이미지를 만듭니다.lifestyle-scene은 주방, 야외, 사무실, 피트니스 환경 등 제품을 사용하는 장면을 만듭니다.model-try-on은 평면 촬영 또는 옷걸이 제품 사진을 원단, 색상, 로고를 유지한 모델 착용 이미지로 변환합니다.selling-point-infographic은 아이콘, 설명 문구, 확인된 카피를 활용해 이미지당 하나의 장점을 보여 주는 인포그래픽을 만듭니다.amazon-a-plus는 지원되는 여러 크기의 Amazon A+ 모듈을 만들고 자르기 스크립트를 포함합니다.size-chart는 사용자가 제공한 숫자와 센티미터, 인치를 사용해 치수 및 의류 사이즈 차트를 만듭니다.multi-angle-set은 정면, 측면, 후면, 상단, 45도 및 디테일 뷰를 일관된 스타일로 만듭니다.sale-banner는 타오바오, 티몰, Shopee, Lazada, TikTok Shop, Amazon 등 마켓플레이스용 캠페인 배너를 만듭니다.batch-background-swap은 재개, 재시도, 예산 상한 및 CSV 로그를 지원하며 여러 이미지 또는 SKU 색상 변형을 처리합니다.xiaohongshu-cover는 6가지 레이아웃 스타일을 사용해 3:4 샤오홍슈 커버를 만듭니다.taobao-detail-long-image는 750픽셀 타오바오, 티몰, 핀둬둬 상세 페이지를 기획하고 이어 붙인 뒤 분할합니다.ecommerce-listing-suite는 오케스트레이터 역할을 하며 완전한 플랫폼 상품 등록 세트를 기획하고 나머지 11개 스킬을 조정합니다.
설치 및 설정
옵션 1: Skills CLI로 설치
가장 빠른 설치 방법은 다음과 같습니다.
npx skills add xianyu110/ecommerce-image-skills저장소를 Claude Code 플러그인으로 추가할 수도 있습니다.
/plugin marketplace add xianyu110/ecommerce-image-skills옵션 2: 스킬 복제 및 복사
먼저 저장소를 복제합니다.
git clone https://github.com/xianyu110/ecommerce-image-skills.git
cd ecommerce-image-skills
전역 Claude Code 설치를 사용하려면 스킬 폴더를 Claude 디렉터리에 복사합니다.
mkdir -p ~/.claude/skills
cp -r skills/* ~/.claude/skills/Codex에서는 다음을 사용합니다.
mkdir -p ~/.codex/skills
cp -r skills/* ~/.codex/skills/Cursor에서는 현재 프로젝트 안에 스킬을 설치합니다.
mkdir -p .cursor/skills
cp -r skills/* .cursor/skills/모든 스킬 폴더는 독립적으로 사용할 수 있습니다. 하나의 스킬만 설치하려면 해당 폴더를 대신 복사합니다.
cp -r skills/amazon-white-background ~/.claude/skills/생성 방식 선택
이미지를 생성하는 방법은 세 가지입니다.
- 에이전트 내장 이미지 도구: 에이전트가 이미지 생성 도구를 제공하면 스킬이 자동으로 사용할 수 있습니다.
- OpenAI 호환 API:
GPTIMAGE_API_KEY를 설정하고 필요에 따라GPTIMAGE_BASE_URL을 설정한 뒤, 포함된 Python 생성 스크립트를 사용합니다. - 키 또는 이미지 도구가 없는 경우: 스킬이 최종 프롬프트와 온라인 실행 링크 gptimage2.asia를 출력합니다.
API 기반 생성을 사용하려면 셸에서 인증 정보를 설정합니다.
export GPTIMAGE_API_KEY=sk-...
export GPTIMAGE_BASE_URL=https://tryallapi.com/v1기본 API 엔드포인트는 https://api.openai.com이지만, 이 저장소는 GPTIMAGE_BASE_URL을 통해 호환 가능한 모든 게이트웨이를 지원합니다.
기본 사용법
Amazon 메인 이미지 만들기
제품 사진을 로컬 폴더에 넣고 에이전트에 관련 스킬을 실행하도록 요청합니다.
Use amazon-white-background on ./photos/bottle.jpg and run the check script.이 스킬은 순백색 배경, 텍스트 없음, 이미지에서 요구되는 비율 이상을 차지하는 제품을 기준으로 설계되었습니다. 생성 후 Python 검사를 실행하고, 필요에 따라 거의 흰색인 픽셀을 보정할 수 있습니다.
완성된 Amazon 세트 생성하기
둘 이상의 에셋이 필요할 때는 오케스트레이터를 사용합니다.
Plan a full 7-image Amazon set for this bottle with ecommerce-listing-suite. Show me the plan first.먼저 계획을 요청하면 생성 전에 예정된 이미지 순서를 검토할 수 있습니다. 오케스트레이터는 개별 스킬을 조율하고 이미지 품질 검사를 수행할 수 있습니다.
라이프스타일 및 소셜 이미지 만들기
제품 장면이 필요할 때는 구체적으로 요청합니다.
Use lifestyle-scene to create three outdoor lifestyle images for ./photos/bottle.jpg.샤오홍슈용 이미지라면 원하는 헤드라인을 지정하고 여러 변형을 요청합니다.
Use xiaohongshu-cover to create three Xiaohongshu covers with the title "A water bottle that stays cold all day".
API를 통해 생성 실행하기
OpenAI 호환 엔드포인트를 사용할 때는 스킬의 생성 스크립트를 호출합니다. 다음 예시는 Amazon 스킬과 Sunburst 모델을 사용합니다.
python skills/amazon-white-background/scripts/generate.py \
--model sunburst \
--image bottle.jpg \
--size 1024x1024 \
--prompt-file prompt.txt \
--out out/main.png정확한 스크립트와 인수는 관련 스킬 폴더에 포함되어 있습니다. 명령을 수정하기 전에 해당 스킬의 작업 흐름과 요구 사항을 확인하려면 SKILL.md를 읽으세요.
메인 이미지 검사 및 보정하기
Amazon 메인 이미지를 생성한 후 검사기를 실행합니다.
python skills/amazon-white-background/scripts/check_main_image.py \
out/main.png \
--fix out/main-fixed.pngREADME의 예시는 이 스크립트를 사용해 거의 흰색인 픽셀을 #FFFFFF로 정규화하고 메인 이미지 요구 사항을 확인합니다.
모델 라우팅: Flare 또는 Sunburst?
새로운 장면, 배경, 레이아웃, 콘셉트 이미지 및 빠른 변형 세트에는 Flare를 사용합니다. Flare는 gpt-image-2.5-flare로 표시됩니다. 라이프스타일 장면, A+ 모듈, 세일 배너, 샤오홍슈 커버 및 타오바오 상세 페이지의 기본 모델입니다.
로고, 라벨 또는 작은 텍스트를 보존하는 것이 중요할 때는 Sunburst를 사용합니다. Sunburst는 gpt-image-2.5-sunburst로 표시됩니다. 배경 변경, 색상 변경, 원치 않는 개체 제거와 같은 로컬 편집에도 권장되는 모델입니다. 이 모델은 저장소의 흰색 배경, 가상 착용, 인포그래픽, 사이즈 차트, 다중 각도 및 일괄 편집 스킬에서 사용됩니다.
안정적인 결과를 위한 고급 팁
제품 식별 확인부터 시작하기
선명한 원본 사진을 사용하고 제품의 형태, 색상, 로고, 라벨 및 보이는 문구를 쉽게 확인할 수 있는지 점검합니다. 제품 식별 잠금 과정은 이 저장소의 접근 방식에서 핵심이므로, 정확한 원본 정보가 이후 모든 이미지의 품질을 높입니다.
탐색과 최종 제작 분리하기
Flare로 여러 장면이나 레이아웃 방향을 탐색한 다음, 제품 세부 정보, 로고 또는 텍스트를 보존해야 하는 최종 이미지에는 Sunburst로 전환합니다. 이렇게 하면 초기 실험은 빠르게 진행하면서 최종 에셋에는 더 신중한 작업 흐름을 적용할 수 있습니다.
생성 후 결정론적 스크립트 사용하기
이미지 모델은 시각적 구성을 만드는 데 유용하지만, 반복 가능한 검사와 변환에는 스크립트가 더 적합합니다. Amazon 이미지에는 흰색 배경 검사기를 실행하고, A+ 모듈에는 자르기 도구를 사용하며, 긴 상세 페이지에는 연결 또는 분할 스크립트를 사용합니다.
배치 한도 설정하기
대규모 폴더에는 최대 호출 예산과 함께 batch-background-swap을 사용합니다. 이 스킬은 재시도, 재개 동작 및 CSV 로그를 지원하므로 전체 배치를 처음부터 다시 시작하지 않고도 중단 상황을 복구할 수 있습니다.
Batch-replace backgrounds in ./photos with pure white, cap at 40 API calls.업로드 전에 플랫폼 규정 검토하기
이 저장소에는 플랫폼별 크기와 표현 규칙이 포함되어 있지만, 마켓플레이스 요구 사항은 변경될 수 있습니다. 이미지를 게시하기 전에 항상 최신 판매자 센터 지침을 확인하세요. 특히 Amazon, 타오바오, 티몰, Shopee, TikTok Shop 및 샤오홍슈의 규정을 확인해야 합니다.
워크플로 예시: 사진 한 장에서 리스팅 세트까지
- 원본 제품 사진을
./photos에 넣고 사진에 보이는 제품 세부 정보를 확인합니다. ecommerce-listing-suite에 대상 마켓플레이스에 맞는 계획을 세우도록 요청합니다.amazon-white-background를 사용해 아마존용 흰색 배경 메인 이미지를 생성합니다.- 메인 이미지 검사기를 실행하고 필요한 경우 수정 옵션을 적용합니다.
lifestyle-scene으로 보조 라이프스타일 장면을 만들고selling-point-infographic으로 주요 특징 그래픽을 제작합니다.- 제품에 필요한 경우 사이즈 차트, 다각도 이미지 또는 A+ 모듈을 추가합니다.
xiaohongshu-cover와sale-banner로 소셜 미디어 또는 캠페인용 에셋을 생성합니다.- 업로드하기 전에 현재 마켓플레이스 요구 사항에 따라 모든 이미지를 검토합니다.
결론
Ecommerce Image Skills는 일반 제품 사진으로 마켓플레이스 및 소셜 커머스 이미지를 제작할 수 있는 실용적이고 재사용 가능한 워크플로를 제공합니다. 선호하는 코딩 에이전트에 스킬을 설치하고, 플랫폼별 스킬을 선택한 다음, 작업에 따라 Flare 또는 Sunburst를 사용하고, 번들로 제공되는 스크립트로 반복 검수와 일괄 처리를 진행하세요. 전체 캠페인의 경우 ecommerce-listing-suite를 사용해 전체 이미지 세트를 계획하고 조정할 수 있습니다.
이 프로젝트는 MIT 라이선스로 배포됩니다. 마켓플레이스 정책은 변경될 수 있으므로 내장된 사양을 워크플로의 기반으로 활용하고, 게시하기 전에 최신 요구 사항을 확인하세요.