사용 가이드로 건너뛰기
imagegen작성자 OpenAI

ImageGen 스킬.

이미지 작업을 위한 Claude Code 및 Codex 스킬: 일러스트레이션, 사진, 텍스처, 스프라이트, 목업 등 래스터 이미지를 생성하거나 편집합니다.

  • Images & Generative Art
  • Image
openai/skills · skills/.system/imagegen/SKILL.mdSKILL.md
--- name: imagegen description: Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better … --- ## Top-level modes and rules ## When to use ## When not to use ## Decision tree ## Workflow ## Prompt augmentation
2026-09-14에 업스트림 파일에서 읽은 전문 및 섹션 제목 · 전체 16,170자

01 기능

Claude Code와 Codex에서 imagegen 스킬이 하는 일

요약, 워크플로, 산출물을 모두 해당 스킬의 SKILL.md에서 그대로 읽어 정리한 내용입니다.

SKILL.md에서2026-09-14 읽음 · 실행 기록 아님

스킬 자체의 표현으로

Imagegen은 Codex에 래스터 이미지 워크플로를 제공합니다: 사진, 일러스트, 텍스처, 스프라이트, 목업, 투명 배경 컷아웃 같은 비트맵 애셋을 생성하거나 편집한 다음 완성된 파일을 프로젝트에 반영합니다. 두 가지 최상위 모드를 정의합니다: API 키가 필요 없는 선호되는 내장 image_gen 도구와, OPENAI_API_KEY가 필요한 scripts/image_gen.py를 통한 명시적 전용 CLI 폴백입니다.

이 파일은 의도(생성 대 편집)를 실행(단일 애셋 대 다수)과 분리하고, 프롬프트, 원문 그대로의 텍스트, 제약 조건, 역할이 표시된 입력 이미지를 수집하여 라벨이 붙은 스키마로 재구성합니다. 주제, 스타일, 구성, 텍스트 정확도에 대한 검증, 단일 변경 반복, 비파괴적 저장으로 마무리됩니다.

산출물

  • 사용자가 래스터 스타일 애셋을 요청한 경우, SVG, HTML/CSS 또는 캔버스 플레이스홀더가 아니라 image_gen을 통해 생성된 비트맵 이미지입니다.
  • 선택된 최종 이미지는 워크스페이스로 이동하거나 복사되며, 이를 사용하는 모든 코드나 참조가 이를 가리키도록 업데이트됩니다.
  • 워크스페이스에 귀속된 모든 애셋의 최종 저장 경로, 최종 프롬프트, 그리고 어떤 모드가 이를 생성했는지를 알려주는 마무리 보고서입니다.
  • 명시적 CLI 폴백에서만, 최종 산출물이 output/imagegen/ 아래에 기록됩니다.
예시 프롬프트 보기 ↗

작동 방식

  1. 01
    최상위 모드를 먼저 선택하세요

    일반적인 생성 및 편집은 내장된 image_gen 도구를 통해 이루어지며, 번들된 CLI는 사용자가 명시적으로 이름을 언급해야 하는 폴백입니다.

  2. 02
    요청을 생성 또는 편집으로 분류하세요

    기존 이미지의 일부를 유지하면서 수정하는 것은 편집입니다. 스타일, 구성, 분위기 참고용으로만 이미지를 제공하는 것은 여전히 생성입니다.

  3. 03
    출력물이 저장될 위치를 결정하세요

    미리보기나 브레인스토밍 작업은 기본 위치에 인라인으로 남을 수 있지만, 프로젝트가 사용하는 모든 것은 워크스페이스에 반영되어야 합니다.

  4. 04
    생성 전 입력값 수집하기

    나중에 빈틈을 메우기보다 프롬프트, 이미지 안에 정확히 들어가야 할 텍스트, 제약 조건이나 제외 목록, 그리고 모든 입력 이미지를 처음부터 수집합니다.

  5. 05
    프롬프트를 스펙으로 재구성하기

    프롬프트는 요청하지 않은 창의적 디테일로 확장되는 대신, 구조화되고 프로덕션 지향적인 스펙으로 정규화됩니다.

  6. 06
    자산당 한 번씩 호출하기

    기본 내장 경로에서는 배치와 변형이 단일 배치 플래그가 아니라, 요청된 자산 또는 변형마다 반복되는 image_gen 호출에서 생성됩니다.

02 적합성 확인

imagegen Skill 사용 시기

Claude Code 또는 Codex에서 이러한 종류의 이미지 작업에는 imagegen 스킬을 사용합니다. 적합성과 제한 사항은 스킬 자체 파일에서 가져옵니다.

적합한 경우

  • 컨셉 아트, 제품 사진, 커버, 웹사이트 히어로 이미지와 같은 완전히 새로운 비트맵을 제작하는 경우.
  • 제공된 이미지가 스타일, 구도, 무드에 대한 참조로만 사용되는 새 이미지를 생성하는 경우.
  • 조명이나 날씨 변경, 배경 교체, 오브젝트 제거, 합성, 투명 배경 컷아웃과 같은 작업을 위해 기존 이미지를 편집하는 경우.
  • 단일 이미지가 아니라 하나의 작업에 대해 여러 자산이나 변형을 제작하는 경우.

한계 인지하기

  • 리포지토리에 이미 존재하는 SVG/벡터 아이콘 세트, 로고 시스템, 또는 일러스트레이션 라이브러리를 확장하거나 그에 맞추는 경우.
  • SVG, HTML/CSS, 또는 캔버스에서 직접 제작하는 것이 더 깔끔한 단순한 도형, 다이어그램, 와이어프레임, 또는 아이콘.
  • 소스 파일이 이미 편집 가능한 네이티브 형식으로 존재하는, 프로젝트 로컬 자산에 대한 소규모 수정.
  • 사용자가 생성된 비트맵이 아니라 결정론적인 코드 네이티브 출력을 명확히 원하는 모든 작업.

제공할 사항

  • 주요 요청사용자의 주요 프롬프트가 주제와 목표를 제공하며, 스펙의 주요 요청 라인으로 옮겨집니다.
  • 명시적 역할이 지정된 입력 이미지제공된 모든 이미지는 생성 전에 참조 이미지, 편집 대상, 또는 보조 삽입/스타일/합성 입력으로 표시됩니다.
  • 정확한 텍스트와 그 타이포그래피이미지 안에 반드시 나타나야 하는 문구는 그대로 인용되며, 서체와 배치가 함께 지정됩니다.
  • 불변 조건과 제외 목록편집 작업의 경우, X만 변경하고 Y는 그대로 유지하는 식으로 변경되어서는 안 되는 것들을 명시적으로 작성합니다.
  • 자산의 사용 목적이미지가 광고, UI 목업, 또는 인포그래픽인지 명시하는 것이 프롬프트가 지향하는 모드와 완성도 수준을 결정합니다.

03 스킬 내부

imagegen 스킬이 Claude Code와 Codex에 부여하는 규칙

SKILL.md가 에이전트에게 설정하는 8가지 구체적인 지시, 기본값, 제한 — 결과를 바꾸는 파일의 부분입니다.

  1. 기본 내장 도구가 기본값입니다

    일반적인 생성 또는 편집 요청은 모두 OPENAI_API_KEY가 필요하지 않은 내장 image_gen 도구를 통해 처리됩니다.

  2. 스스로 다운그레이드하지 않습니다

    에이전트는 스스로 CLI 경로로 전환해서는 안 되며, 그 전환은 항상 사용자의 결정입니다.

  3. 요청받았을 때만 CLI 사용

    사용자가 CLI 모드를 선택한 경우에는 번들로 제공되는 scripts/image_gen.py 워크플로를 사용하며, 일회성 SDK 실행 스크립트를 작성하지 않습니다.

  4. 번들 스크립트는 읽기 전용입니다

    scripts/image_gen.py는 수정하지 않습니다. 여기에 누락된 부분이 있다면 다른 작업을 하기 전에 먼저 사용자에게 확인합니다.

  5. 프로젝트 산출물은 $CODEX_HOME에 남아 있을 수 없습니다

    프로젝트에서 참조하는 파일은 작업이 끝나기 전에 기본 생성 이미지 위치에서 이동하거나 복사해 내보내야 합니다.

  6. 덮어쓰기 대신 버전 관리

    기존 산출물은 사용자가 명시적으로 교체를 요청한 경우에만 대체됩니다. 그렇지 않으면 새 파일은 hero-v2.png와 같이 형제 관계의 버전이 붙은 이름을 갖게 됩니다.

  7. 편집 시 불변 조건 유지

    편집 작업은 변경되어서는 안 되는 부분을 고정해 두고, 원본 산출물을 다시 쓰는 대신 비파괴적으로 저장합니다.

  8. 기본 제공 경로에서는 키를 다루지 않습니다

    에이전트는 image_gen을 사용하는 동안 OPENAI_API_KEY를 요청하지 않으며, 사용자에게 전체 키를 채팅에 붙여넣도록 요청하지도 않습니다.

04 활용하기

Claude Code 또는 Codex에 imagegen 설치

npx skills add 명령 한 번 실행 후, 에이전트에서 첫 번째 작업을 수행하고 결과 체크리스트를 확인합니다.

Claude Code, Codex 또는 귀하의 에이전트에 imagegen 추가

프로젝트에서 실행합니다. 설치 프로그램이 어떤 에이전트에 추가할지 묻습니다.

Terminal
npx skills add https://github.com/openai/skills --skill imagegen

skills/.system/imagegen/SKILL.md에 대한 일반적인 skills CLI 형식이며, 저장소는 자체 경로를 별도로 문서화할 수 있습니다.

Skill에 첫 번째 이미지 작업 과제 제공

이 프롬프트를 자신의 콘텐츠와 제약 조건으로 수정한 다음 Claude Code 또는 Codex에서 실행하십시오.

Example prompt
Use case: product-mockup Asset type: landing page hero Primary request: a minimal hero image of a ceramic coffee mug Style/medium: clean product photography Composition/framing: wide composition with usable negative space for page copy if needed Lighting/mood: soft studio lighting Constraints: no logos, no text, no watermark

출처: SKILL.md 예시(원문 그대로).

첫 번째 결과 확인

SKILL.md 자체가 올바른 결과의 모습으로 제시하는 내용:

  • 주제, 스타일, 구성, 텍스트 정확성 및 불변 조건에 맞춰 결과물을 검토하고, 사전에 합의한 항목은 피합니다.
  • 여러 변경 사항을 한 번의 반복에 몰아넣기보다는, 하나의 목표한 변경을 적용한 뒤 다시 확인합니다.
  • 편집 시에는 반복마다 불변 조건을 다시 명시하여 이미지가 유지되어야 할 부분에서 벗어나지 않도록 합니다.

OpenDesign에서는 imagegen이 기본 포함되어 있습니다: Plugins → Skills에서 상단 바에서 선택합니다.

05 오픈 소스, 추적 가능

출처, 라이선스 및 검증

이 페이지의 사실이 어디에서 왔으며 언제 마지막으로 확인되었는지 안내합니다.

Author
OpenAI
Repository
github.com/openai/skills 브랜치 main
스킬 파일
skills/.system/imagegen/SKILL.md 검증 시 기록된 콘텐츠 체크섬, 커밋 49f948f
License
Apache-2.0 skills/.system/imagegen/LICENSE.txt에서 확인. 스킬은 오픈 소스이지만 이미지 생성은 여전히 호스팅 서비스에 의존합니다.
리포지토리 스타
27,129 전체 openai/skills 저장소에 대해 2026-09-14에 촬영한 GitHub 스냅샷입니다. imagegen에 대한 평가나 사용 횟수가 아닙니다.
OpenDesign에서 검증됨
2026-09-14 소스 파일, 경로, 라이선스 텍스트 및 별 개수가 확인되었습니다. OpenDesign 메인에 번들로 포함됨(2026-08-28 확인됨); 이 페이지에 실시간 실행이 기록되지 않았습니다.

SKILL.md 내부

  1. 최상위 모드와 규칙기본 제공 image_gen이 기본값이며, CLI 대체는 명시적으로 지정한 경우에만 사용하고, 저장 경로 우선순위와 덮어쓰기 제한이 있습니다.
  2. 사용 시점새 이미지, 레퍼런스 기반 생성, 기존 이미지 편집, 다수의 산출물이나 변형이 필요한 경우입니다.
  3. 사용하지 않을 시점저장소 네이티브 벡터 시스템, 코드 네이티브 도형, 편집 가능한 네이티브 파일, 결정적 코드 네이티브 출력이 필요한 경우입니다.
  4. 의사결정 트리의도(생성 대 편집)를 실행 전략(단일 산출물 대 다수 산출물)과 분리합니다.
  5. 워크플로모드 선택부터 프롬프트 구성, 생성, 검증, 보고까지 17단계로 이루어져 있습니다.
  6. 프롬프트 보강프롬프트를 프로덕션 스펙으로 구조화하며, 구체성에 따라 허용되는 보강과 금지되는 보강을 구분합니다.
  7. 사용 사례 분류(정확한 슬러그)프롬프트와 레퍼런스 전반에서 일관성을 유지하기 위한 고정된 생성 및 편집 슬러그입니다.
  8. 공유 프롬프트 스키마자산 유형, 장면, 주체, 조명, 문자 그대로의 텍스트, 회피 목록 등 이름이 붙은 스캐폴딩 필드입니다.
  9. 예시히어로 이미지 생성 스펙과, 불변 요소를 명시한 배경 교체 편집 스펙입니다.
  10. 프롬프트 작성 모범 사례순서 지정, 정확한 텍스트 인용, 다중 이미지 인덱싱, 단일 변경 후속 요청을 통한 반복 작업입니다.
  11. 자산 유형별 가이드웹사이트, 게임, 와이어프레임, 로고 작업을 위한 자산 유형별 템플릿을 sample-prompts.md에서 안내합니다.
  12. 대체용 CLI 모드 전용CLI 임시/출력 규칙, uv 의존성, OPENAI_API_KEY 설정 단계입니다.
스킬 자체 설명
"사진, 일러스트레이션, 텍스처, 스프라이트, 목업 또는 투명 배경 컷아웃과 같이 AI가 생성한 비트맵 비주얼이 유익한 경우 래스터 이미지를 생성하거나 편집합니다. Codex가 새로운 이미지를 생성하거나, 기존 이미지를 변환하거나, 참조에서 시각적 변형을 도출해야 하고 출력이 레포 네이티브 코드나 벡터가 아닌 비트맵 에셋이어야 하는 경우 사용합니다. 기존 SVG/벡터/코드 네이티브 에셋을 편집하거나, 확립된 아이콘 또는 로고 시스템을 확장하거나, HTML/CSS/캔버스에서 직접 비주얼을 구축하는 것이 더 나은 경우 사용하지 않습니다."

SKILL.md의 프론트매터 설명입니다. 전체 파일은 약 16,170자입니다. GitHub에서 전체 파일 읽기.

ImageGen

실제 이미지 작업 과제에서 imagegen을 실행합니다.

imagegen 스킬은 OpenDesign 내부에 포함되어 있습니다. 앱을 다운로드하고 Plugins → Skills에서 스킬을 선택한 후 위의 프롬프트를 붙여넣고 결과 전에 계획을 읽습니다.

터미널
npx skills add https://github.com/openai/skills --skill imagegen