OG 이미지
세 가지 종류의 이미지로, 모두 하나의 목적을 가집니다: 누군가가 링크에서 멈추고 앱을 한눈에 이해하게 만드는 것입니다. 각 이미지는 큰 타이틀이 있는 앱의 실제 캡처이며, 브랜드 배경 또는 밝은 배경화면 위에 배치됩니다. UI가 주인공입니다. 프레임 외에는 아무것도 그려지지 않습니다.
출력물은 사용자 저장소의 launch-assets/og/ 폴더에 생성됩니다:
| 파일 | 크기 | 설명 |
|---|---|---|
og.png | 1200×630 | 홈페이지의 링크 미리보기. |
og-<id>.png | 1200×630 | 선택 사항: 사이트의 각 페이지별로 하나씩, 동일한 디자인에 해당 페이지의 타이틀 적용. |
ph/01-<id>.png … 06 | 1270×760 | Product Hunt 갤러리, 4~6장. 1번 슬라이드는 히어로 이미지. |
x-header.png | 1500×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, SwiftColor정의에서 추출. 라이트 값을 사용합니다. 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을 가리키는 위치. 선택 사항이며, 없으면 태그에 플레이스홀더가 포함됩니다.
단계
-
캡처. 기존 파일을 재사용합니다:
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) 실제로 확인합니다. -
텍스트 작성
- 링크 타이틀: 앱의 한 줄 설명 또는 페이지 자체 타이틀을 사이트의 표현 그대로 사용: 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명령으로 사이트 사본과 대조 확인합니다. - 링크 타이틀: 앱의 한 줄 설명 또는 페이지 자체 타이틀을 사이트의 표현 그대로 사용: 9단어 이하, 문장형, 마침표 없음, 대시 없음,
-
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도 이상 차이가 나는 경우 브랜드 필드 (브랜드 배경에 약간의 강조색이 섞인)를 대신 사용합니다. 키를 생략하면 필드가 사용됩니다. 이 스킬에는 다섯 개의 이미지가 번들로 제공됩니다. -
렌더링.
node <skill-folder>/scripts/render.mjs launch-assets/og/og.jsonPNG 하나당 한 줄 출력:
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에서 수정하고 다시 렌더링합니다. -
QA 검증. 필수이며, 설정이 아닌 파일을 대상으로 수행합니다.
- 크기 및 알파:
sips -g pixelWidth -g pixelHeight -g hasAlpha <각 파일>. sizes.md의 정확한 크기,hasAlpha: no여야 함. - 시각 확인: 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와, 가능하다면 실제 프로필에서 확인.
- 세트: 슬라이드가 하나의 패밀리로 읽히며, 두 슬라이드가 동일한 포인트를 만들지 않아야 함.
- 수정 후 다시 렌더링, 그런 다음 해당 파일을 다시 확인합니다.
- 그런 다음에만 보고: 파일 목록,
sips출력, 확인할 수 없었던 사항. 사용자에게 PNG를 사이트에 복사하고,meta.html을<head>에 붙여넣고, 각 플랫폼의 디버거에서 캐시된 미리보기를 새로고침하도록 안내합니다.
- 크기 및 알파:
디자인 규칙
- 라이트 우선. 밝은 배경화면 또는 브랜드 필드, 그 위에 어두운 잉크. 네온이 있는 어두운 배경은 사용하지 않음.
- 광택이나 헤일로 없음. 깊이는 1px 가장자리와 낮은 불투명도의 중성 검은색 그림자로 표현.
- 이미지당 하나의 역할. 하나의 타이틀, 하나의 캡처(또는 한 쌍), 최대 하나의 서브라인.
- 큰 타입. 타이틀은 썸네일에서도 살아남는 요소. 짧은 텍스트가 큰 글씨를 가능하게 함.
- 실제 캡처만 사용. UI는 절대 그려지거나, 다시 그려지거나, 생성되지 않음.