Community이미지github.com

og-images

앱의 실제 UI로부터 소셜 미리보기, Product Hunt 갤러리, X 헤더 이미지를 생성합니다.

og-images란 무엇인가요?

이 스킬은 앱의 실제 UI 캡처를 기반으로 소셜 미리보기 이미지(Open Graph, X 카드), Product Hunt 갤러리, X 헤더 이미지를 제작합니다. 각 이미지는 앱의 브랜드 컬러나 제공되는 배경화면 위에 큰 가독성 좋은 타이틀, 앱 아이콘, 실제 UI 스크린샷을 배치하여 링크 클릭을 유도합니다. 지원하는 출력물로는 1200×630 크기의 OG 이미지, 사이트 페이지별 맞춤 미리보기, 4~6장의 1270×760 Product Hunt 슬라이드, 1500×500 X 헤더 이미지, 그리고 `<meta>` 태그가 포함된 HTML 파일이 있습니다. 이 스킬은 Node.js와 Playwright를 사용하며, 캡처 규칙(실제 UI, 정착된 상태, 중립 데모 데이터, 라이트 모드 등)을 엄격히 적용하고, 최종 파일의 크기, 알파 채널 유무, 텍스트 대비, 타이틀 크기, 안전 영역, 폰트 폴백 등을 자동 검증합니다. 주로 앱 출시, UI 변경, 또는 현재 소셜 미리보기가 부족할 때 사용됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abdiraimov-otabek/claude-code-og-image-skill/tree/main/skills/og-images

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

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

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

문서

OG 이미지

세 가지 종류의 이미지로, 모두 하나의 목적을 가집니다: 누군가가 링크에서 멈추고 앱을 한눈에 이해하게 만드는 것입니다. 각 이미지는 큰 타이틀이 있는 앱의 실제 캡처이며, 브랜드 배경 또는 밝은 배경화면 위에 배치됩니다. UI가 주인공입니다. 프레임 외에는 아무것도 그려지지 않습니다.

출력물은 사용자 저장소의 launch-assets/og/ 폴더에 생성됩니다:

파일크기설명
og.png1200×630홈페이지의 링크 미리보기.
og-<id>.png1200×630선택 사항: 사이트의 각 페이지별로 하나씩, 동일한 디자인에 해당 페이지의 타이틀 적용.
ph/01-<id>.png … 061270×760Product Hunt 갤러리, 4~6장. 1번 슬라이드는 히어로 이미지.
x-header.png1500×500아바타와 폰 크롭 영역이 비어 있는 X 헤더.
meta.html<head>에 붙여넣을 <meta> 태그.

크기, 안전 영역, 출처 및 날짜는 references/sizes.md에 있습니다.

사용 시기

  • 출시 시 공유 이미지, Product Hunt 갤러리 또는 X 헤더가 필요한 경우.
  • 현재 사이트의 og:image가 단색 배경에 로고만 있거나 아예 없는 경우.
  • 릴리스로 인해 UI가 변경되어 새 캡처로 미리보기를 다시 렌더링해야 하는 경우.

캡처는 Mac 스타일의 가로 창 또는 아일랜드 형태입니다. 세로 방향의 전화 화면은 이러한 카드에서 지원되지 않습니다. 다음의 경우에는 사용하지 않습니다: App Store 스크린샷 (다른 스킬, 다른 크기 사용), 또는 앱에 없는 UI가 필요한 모든 것. 이 스킬은 UI를 절대 그리지 않습니다.

설정 (최초 1회)

Node 20 이상 필요. Playwright는 이 스킬의 폴더에 설치하며, 사용자 저장소가 아닙니다:

npm install --prefix <skill-folder> [email protected] && npx --prefix <skill-folder> playwright install chromium

Playwright가 없으면 render.mjs가 이 메시지를 출력하고 종료 코드 2를 반환합니다.

0단계. 브랜드 정보

사용자 저장소에서 launch-assets/brand.json을 읽습니다. 파일이 있으면 사용하고, 없으면 저장소에서 각 필드를 감지하여 파일을 작성합니다. 찾을 수 없는 항목에 대해서만 한 번의 메시지로 사용자에게 질문합니다.

{
  "appName": "Halo", "oneLiner": "Mac을 위한 Dynamic Island", "platform": "macos",
  "colors": { "bg": "#f5f5f7", "ink": "#1d1d1f", "accent": "#0071e3" },
  "fonts": { "family": "-apple-system, 'SF Pro Display', sans-serif", "file": null, "google": null },
  "iconPath": "site/assets/icon.png",
  "screenshotDirs": ["launch-assets/captures"],
  "siteUrl": "https://example.com"
}
  • appName, oneLiner: README 제목 및 첫 줄, 사이트의 <title> 및 <h1>, Info.plist에서 추출.
  • colors: 사이트의 CSS 변수, Asset Catalog의 AccentColor, Swift Color 정의에서 추출. 라이트 값을 사용합니다. 16진수로 작성합니다 (#0d7f76). rgb(), oklch(), hsl() 값은 먼저 변환합니다. 렌더러가 읽을 수 없는 값은 회색으로 간주합니다.
  • fonts.family (CSS 스택), fonts.file (저장소에 포함된 폰트 파일, 저장소 루트 기준 상대 경로, launch-assets 상위 폴더, 또는 null), fonts.google (예: Geist:wght@400;600, 또는 null). 브랜드 폰트는 저장소에 파일이 포함된 경우에만 사용합니다. 그렇지 않으면 시스템 스택 또는 Google Fonts를 사용합니다. 독점 폰트를 사용자 저장소에 절대 복사하지 마십시오.
  • iconPath: 앱 아이콘, 정사각형 PNG (1024px 권장), 저장소 루트 기준 상대 경로. 사이트의 assets, Asset Catalog의 AppIcon, 파비콘 폴더에서 찾습니다. 필수: 아이콘과 이름은 모든 이미지에 표시됩니다.
  • siteUrl: meta.html이 이미지 URL을 가리키는 위치. 선택 사항이며, 없으면 태그에 플레이스홀더가 포함됩니다.

단계

  1. 캡처. 기존 파일을 재사용합니다: launch-assets/captures/, screenshotDirs, 또는 이전 launch-assets/store-screenshots/shots.json. 아래 규칙을 통과하는 캡처가 없을 때만 새로 촬영합니다. 먼저 앱 자체의 캡처 방식을 찾습니다: 소스, README 및 Package.swift에서 rg -i "demo|snapshot|screenshot|marketing" 명령으로 스냅샷, 데모 또는 샘플 데이터 플래그를 검색합니다 (예: MyApp --snapshot <dir> 또는 MYAPP_DEMO=1). 플래그를 실행하기 전에 무엇을 하는지 읽습니다. 사용자 데이터를 스캔, 정리 또는 쓰는 작업은 절대 실행하지 않으며, 라이브 상태를 유지하는 앱의 두 번째 복사본을 실행하지 않습니다. 플래그가 이 중 하나라도 수행할 수 있다면 중단하고 질문합니다. 그렇지 않은 경우, Mac에서 보여줄 상태의 앱을 전면으로 가져와 다음을 실행합니다: swift <skill-folder>/scripts/capture-window.swift "MyApp" capture.png (화면상 가장 큰 창, 그림자 없음, Retina 픽셀; 노치 또는 메뉴 바 앱 패널은 더 높은 창 레이어에 있으므로 건너뛰고 알림). iOS: xcrun simctl status_bar booted override --time 9:41 --batteryState charged --batteryLevel 100, 그 다음 xcrun simctl io booted screenshot capture.png, 그 다음 xcrun simctl status_bar booted clear.

    모든 캡처에 대한 규칙:

    • 실제 UI, 포커스 상태. 활성 창: 컬러 교통 신호등, 강조 표시된 사이드바. 회색, 흐릿한 창은 실패.
    • 정착된 상태. 진행 중인 카운터, 스피너, 반쯤 그려진 요소 없음.
    • 중립 데모 데이터. 개인 이름, 실제 파일, 프로젝트 또는 계정 이름, 다른 회사의 제품 이름 없음 (앱 자체 사이트에서 해당 통합을 언급하는 경우 제외). 데모 모드를 사용하고 실제 스크린샷은 절대 사용하지 않음.
    • 라이트 모드 (앱이 라이트 모드를 지원하는 경우). 다크 모드 캡처는 다크 모드 전용 앱에만 사용.
    • 2x 픽셀. 카드는 캡처 자체 픽셀의 최대 1.15배까지 표시합니다 (그 이상은 렌더링 실패). 따라서 링크 미리보기에는 약 1400px 너비의 창이 필요하고, 갤러리 슬라이드에는 2000px가 필요합니다.
    • 실제 콘텐츠. 빈 칸, 로렘 입숨, 타이틀이 설명하는 부분의 텍스트 잘림 없음.
    • 작게 읽히는 것. 링크 미리보기는 약 600px 너비로 캡처를 표시합니다. 그 크기에서 주요 포인트가 보이는 캡처를 선택하세요 (큰 숫자, 명확한 목록). 복잡한 설정 창은 피하고, 중요한 부분을 자르세요.
    • SwiftUI ImageRenderer 캡처 (노치 앱의 아일랜드)의 모서리 플레어에는 불투명 노란색 플레이스홀더가 있습니다: "clean": true로 설정합니다. 카드에 떠 있는 아일랜드의 경우, "square": true를 추가하여 모서리 플레어를 본문 가장자리로 정사각형 처리합니다. 빈 노치 행은 crop으로 잘라내세요.

    각 캡처가 모든 조건을 통과할 때까지 진행합니다. 모든 파일의 크기를 읽고 (sips -g pixelWidth -g pixelHeight) 실제로 확인합니다.

  2. 텍스트 작성

    • 링크 타이틀: 앱의 한 줄 설명 또는 페이지 자체 타이틀을 사이트의 표현 그대로 사용: 9단어 이하, 문장형, 마침표 없음, 대시 없음, ! 없음. 카드에서 유일하게 큰 텍스트이므로 짧을수록 더 크게 표시됩니다.
    • 페이지: 저장소에 여러 페이지가 있는 사이트가 있다면 node <skill-folder>/scripts/pages.mjs <site-folder>를 실행합니다. 각 페이지의 <title>과 <h1>을 출력합니다. 자체 미리보기가 필요한 페이지를 선택하세요 (가이드, 가격 페이지, 주요 기능). 다른 회사의 제품명을 포함하는 페이지는 건너뜁니다. <h1> 또는 둘 중 더 짧은 것을 사용하고, 사이트명 접미사와 "(2026)" 스타일 태그를 제거하고, 9단어 이하로 유지합니다. 의역하지 마십시오.
    • 슬라이드: launch-assets/store-screenshots/shots.json이 존재하는 경우, "ph": { "fromShots": "../store-screenshots/shots.json" }은 해당 파일의 헤드라인, 서브라인, 캡처 및 크롭을 재사용합니다 (처음 6개 샷, "limit"으로 변경 가능). 그렇지 않으면 4~6개의 슬라이드를 작성합니다: 슬라이드 1은 앱이 무엇인지 설명하고, 이후 각 슬라이드는 하나의 이점을 가지며 단독으로도 의미가 있어야 합니다. 헤드라인은 6단어 이하, 선택적 서브라인은 한 문장.
    • X 헤더 타이틀: 한 줄 설명. 6단어 이하.
    • 대체 텍스트: 이미지가 무엇을 보여주는지 한 문장. 기본값은 <app>: <title>. <subline>이며, 캡처에 추가로 언급할 가치가 있는 내용이 있을 때 링크에 alt를 작성합니다.

    텍스트는 사이트 자체의 표현을 사용합니다. 모든 줄은 사이트 또는 README에서 가져와 짧게 만듭니다. 모든 숫자, 이름 및 주장은 사이트에 있는 내용입니다. 각 줄을 유지하기 전에 rg 명령으로 사이트 사본과 대조 확인합니다.

  3. launch-assets/og/og.json 작성.

    {
      "brand": "../brand.json",
      "out": ".",
      "wallpaper": "auto",
      "link": {
        "title": "개발자를 위한 Mac 청소기",
        "capture": "../captures/overview.png",
        "alt": "Shedi, 개발자를 위한 Mac 청소기: 43.84 GB 발견, 안전하게 청소 가능 및 먼저 확인 항목으로 분류"
      },
      "pages": [
        { "id": "xcode-deriveddata", "title": "Xcode DerivedData 정리", "capture": "../captures/xcode.png" }
      ],
      "ph": { "fromShots": "../store-screenshots/shots.json" },
      "x": { "title": "개발자를 위한 Mac 청소기", "capture": "../captures/overview.png" }
    }
    

    pages, ph 또는 x를 생략하면 해당 종류를 건너뜁니다. 경로는 og.json 기준 상대 경로입니다. 페이지는 link의 모든 설정(캡처, 크롭, 레이아웃)을 상속하고 명시한 항목을 재정의합니다. link, 페이지, 슬라이드 또는 x에 설정 가능한 옵션:

    • capture (또는 captures, 최대 3개, 스택), crop ({ x, y, w, h }, 투명 여백이 제거된 캡처의 0~1 사이 값; 여러 캡처의 경우 crops), clean, square, radius, width (카드 너비 대비 캡처 너비 비율), shadow: false, minCoverage.
    • layout: 링크 카드는 side (타이틀 왼쪽, 창이 오른쪽 아래에서 올라옴) 또는 below (타이틀 중앙 정렬, 넓은 캡처가 아래에 위치). 기본값은 2:1보다 넓은 캡처는 below, 그렇지 않으면 side. 슬라이드는 fit (캡처 전체, 잘림 없음), bleed (아래쪽 가장자리에서 잘림, 창용), pair (2~3개 캡처 스택). layout이 없고 하나의 일반 창 캡처(clean 없음)인 슬라이드는 bleed, 그 외는 fit.
    • minCoverage: UI 커버리지 최소값 (링크 0.3, 슬라이드 0.4, 헤더 0.12). 카드 너비의 80%를 차지하는 캡처는 이 기준 없이 통과합니다 (얇은 아일랜드나 바는 더 커질 수 없음). 작은 캡처를 숨기기 위해 기준을 낮추지 마십시오: 더 크게 표시하거나, 크롭하거나, 다른 캡처를 선택하세요.
    • fromShots의 슬라이드에 대해 "slides": [{ "id": "<shot id>", ... }]을 추가하여 특정 슬라이드의 옵션을 재정의합니다.

    배경, 모든 이미지에 대해 한 번만 설정: "wallpaper": "auto"는 번들 이미지 중 브랜드 강조색에 가장 가까운 색조(파랑 및 청록, 녹색, 따뜻함, 분홍)의 이미지를 선택하고 선택 이유를 출력합니다. 사용자에게 선택된 배경과 이유를 알리고 변경 가능함을 알립니다 ("wallpaper": "snow", 또는 자신의 밝고 차분한 이미지 경로, 최소 2400px 너비). 회색 강조색이거나 모든 이미지와 50도 이상 차이가 나는 경우 브랜드 필드 (브랜드 배경에 약간의 강조색이 섞인)를 대신 사용합니다. 키를 생략하면 필드가 사용됩니다. 이 스킬에는 다섯 개의 이미지가 번들로 제공됩니다.

  4. 렌더링.

    node <skill-folder>/scripts/render.mjs launch-assets/og/og.json
    

    PNG 하나당 한 줄 출력: ok 또는 FAIL, 크기, 파일 무게, 실제로 타이틀을 그린 폰트, 단어와 실제 뒤 픽셀 간 대비, 타이틀 크기 및 대문자 높이, UI 커버리지, 캡처 및 배경화면이 확대된 정도. --only link|pages|ph|x로 한 종류만 렌더링 가능 (그 외는 실패). 또한 meta.html을 작성합니다.

    검사 실패 조건: 정확한 크기가 아닌 경우, 알파 채널이 있는 경우, 파일 5MB 초과, 텍스트 대비 4.5:1 미만 (스크림 없음; 더 연한 배경화면 또는 더 진한 잉크를 선택), 타이틀 대문자 높이가 최소값 미만 (링크 40px, 슬라이드 38px, 헤더 36px, 600px 너비 미리보기에서도 읽혀야 함) 또는 설정된 줄 수를 초과하거나, 너무 길거나 대시(" - " 또는 "--") 또는 !가 포함된 경우, 캡처가 1.15배 이상 확대되거나 배경화면이 1.2배 이상 확대된 경우, UI 커버리지가 최소값 미만이면서 캡처가 카드 너비의 80% 미만인 경우 (캡처의 콘텐츠 픽셀 기준, 박스가 아닌 실제 픽셀 측정, 따라서 검은색 또는 흰색 빈 영역은 포함되지 않음), X 안전 영역 밖 또는 아바타 영역 안에 있는 경우, 폰트 폴백이 발생한 경우: fonts.family의 첫 번째로 지정된 패밀리가 실제로 타이틀을 그린 폰트여야 함 ("Inter, sans-serif"에 파일이 없으면 SF Pro로 그려지므로 FAIL). -apple-system 또는 system-ui로 시작하는 스택은 시스템 폰트를 의미하며, Helvetica나 Arial과 같은 폴백에서만 실패합니다. 모든 FAIL을 og.json에서 수정하고 다시 렌더링합니다.

  5. QA 검증. 필수이며, 설정이 아닌 파일을 대상으로 수행합니다.

    1. 크기 및 알파: sips -g pixelWidth -g pixelHeight -g hasAlpha <각 파일>. sizes.md의 정확한 크기, hasAlpha: no여야 함.
    2. 시각 확인: Read 도구로 모든 PNG를 전체 크기로 엽니다. 그런 다음 node <skill-folder>/scripts/preview.mjs launch-assets/og를 실행하고 _preview-600.png와 _preview-300.png를 엽니다 (모든 이미지를 600px 및 300px 너비로 표시, 피드에서 보여지는 대로). 그런 다음 두 파일을 삭제합니다. 각 이미지에 대해 확인:
      • 타이틀이 300px에서 읽을 수 있고, 잘리거나 두 번째 줄에 혼자 남는 부분이 없는지.
      • 출력 줄의 폰트가 요청한 폰트인지.
      • 캡처가 선명하고, 타이틀의 요점을 보여주며, 텍스트 잘림이나 개인 데이터가 없는지.
      • 이름: 경쟁사나 다른 회사의 이름 또는 로고가 없어야 함 (사이트에서 해당 통합을 언급하는 경우 제외), 개인 이름 없음.
      • 단어: 모든 줄이 사이트 자체 표현이며 짧게 만들어진 것, 모든 숫자가 사이트에 있는 것.
      • X 헤더: 왼쪽 아래 (x 420 미만, y 300 초과)가 프로필 사진을 위해 비어 있어야 함; 콘텐츠는 중간 밴드에 위치하며 상단 및 하단 70px에서 떨어져 있어야 함. sizes.md와, 가능하다면 실제 프로필에서 확인.
      • 세트: 슬라이드가 하나의 패밀리로 읽히며, 두 슬라이드가 동일한 포인트를 만들지 않아야 함.
    3. 수정 후 다시 렌더링, 그런 다음 해당 파일을 다시 확인합니다.
    4. 그런 다음에만 보고: 파일 목록, sips 출력, 확인할 수 없었던 사항. 사용자에게 PNG를 사이트에 복사하고, meta.html을 <head>에 붙여넣고, 각 플랫폼의 디버거에서 캐시된 미리보기를 새로고침하도록 안내합니다.

디자인 규칙

  • 라이트 우선. 밝은 배경화면 또는 브랜드 필드, 그 위에 어두운 잉크. 네온이 있는 어두운 배경은 사용하지 않음.
  • 광택이나 헤일로 없음. 깊이는 1px 가장자리와 낮은 불투명도의 중성 검은색 그림자로 표현.
  • 이미지당 하나의 역할. 하나의 타이틀, 하나의 캡처(또는 한 쌍), 최대 하나의 서브라인.
  • 큰 타입. 타이틀은 썸네일에서도 살아남는 요소. 짧은 텍스트가 큰 글씨를 가능하게 함.
  • 실제 캡처만 사용. UI는 절대 그려지거나, 다시 그려지거나, 생성되지 않음.

관련 스킬