carousel-maker
인스타그램 캐러셀(카드뉴스, 인스타 공식 최대 세로 비율 3:4 1080×1440 PNG)을 브리프 → 팩트시트 → 원고 → 스타일 선택 → A/B 변형 → 렌더·자동 게이트 → 발행 패키지 순서로 만든다. 실무자가 캐러셀/카드뉴스를 만들거나, 디자인 스타일을 고르거나, 표지·2번 카드·CTA·표지 사진·장수·순서·스타일 중 하나를 A/B로 비교하려 할 때 사용한다.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/min9lin9--carousel-maker)HTML
<a href="/listings/min9lin9--carousel-maker"><img src="/api/listings/min9lin9--carousel-maker/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Claude Code에 이렇게 말하면 됩니다.
> https://github.com/min9lin9/carousel-maker 스킬 적용해줘
Claude Code / AI 에이전트용 설치 절차
사용자가 이 저장소를 설치해 달라고 하면 아래를 그대로 실행하세요. 기본은 **현재 프로젝트에만** 설치합니다(사용자가 전역 설치를 명시한 경우에만 `~/.claude/skills/carousel-maker`).
git clone --depth 1 https://github.com/min9lin9/carousel-maker.git .claude/skills/carousel-maker (cd .claude/skills/carousel-maker && npm install && npx playwright install chromium) node .claude/skills/carousel-maker/scripts/carousel.mjs styles
마지막 명령이 스타일 4개를 출력하면 설치 완료입니다. 새 세션에서 "캐러셀 만들어줘"라고 하면 `SKILL.md` 절차대로 진행합니다.
요구사항: Node.js 20 이상, 렌더할 때 인터넷(웹폰트 CDN).
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 74 lines
- ---
- name: carousel-maker
- description: 인스타그램 캐러셀(카드뉴스, 인스타 공식 최대 세로 비율 3:4 1080×1440 PNG)을 브리프 → 팩트시트 → 원고 → 스타일 선택 → A/B 변형 → 렌더·자동 게이트 → 발행 패키지 순서로 만든다. 실무자가 캐러셀/카드뉴스를 만들거나, 디자인 스타일을 고르거나, 표지·2번 카드·CTA·표지 사진·장수·순서·스타일 중 하나를 A/B로 비교하려 할 때 사용한다.
- ---
- # carousel-maker
- 캐러셀 한 편을 **같은 절차, 같은 품질 기준**으로 만들게 하는 스킬입니다. 렌더는 `scripts/carousel.mjs`가 하고, 숫자 날조·글 넘침·작은 글씨·낮은 대비·폰트 누락·빈 자리표시는 자동 게이트가 막습니다.
- ```
- SK=.claude/skills/carousel-maker/scripts/carousel.mjs
- node $SK init content/<주제폴더> # 프로젝트 생성
- node $SK styles --preview /tmp/styles # 스타일 고르기 (styles.png)
- node $SK render content/<주제폴더> # 렌더 + 게이트 (A/B가 있으면 둘 다)
- ```
- 처음 설치: 스킬 폴더에서 `npm install && npx playwright install chromium` (README의 설치 절차). 폰트는 CDN에서 받으므로 렌더할 때 인터넷이 필요합니다.
- ## 절차
- 각 단계는 앞 단계가 끝나야 진행합니다. ⛔ 표시는 사람 승인 없이 넘어가지 않습니다.
- 1. **init** — `node $SK init content/<YYYY-WW>-<slug>`. `brief.md`, `facts.md`, `carousel.json`, `sources/`가 생깁니다.
- 2. **브리프** — `brief.md`를 채웁니다. 한 줄 메시지, 독자, 원하는 행동 **하나**, A/B로 확인할 것.
- 3. **팩트시트** — `facts.md`에 카드·캡션에 쓸 숫자와 고유 정보를 출처와 함께 적습니다. 클라이언트에게 확인받지 않은 가격·영업시간·수상·리뷰 수는 쓰지 않습니다. **여기 없는 숫자가 카드에 들어가면 렌더가 실패합니다.**
- 4. **원고** — Claude가 `brief.md`와 `facts.md`만 근거로 구조 → 카드별 요지 → `carousel.json` 초안 → 표지 훅 후보 2~3개 순서로 씁니다. 절차·분량·훅 10유형·마감 점검은 `references/copywriting.md`, 문장 기준은 `references/writing-voice.md`, 필드는 `references/schema.md`. 최종 문장은 담당자가 자기 말투로 고치고, Claude는 그 문장을 다시 다듬지 않습니다.
- 5. ⛔ **승인 ① 원고** — 디자인 전에 원고(`carousel.json`의 문구)를 승인받습니다. 글은 디자인 뒤에 고치면 비용이 몇 배입니다.
- 6. **스타일 선택** — `node $SK styles --preview <폴더>`로 `styles.png`를 보여 주고 고르게 합니다. 고른 id를 `style`에 넣습니다. 확신이 없으면 `--style`로 두 개를 각각 렌더해 비교하거나 A/B의 `style` 변수로 넘깁니다.
- 7. **A/B (선택)** — 변수 **하나**만 고릅니다: `hook`, `second_hook`, `cta`, `cover_image`, `style`, `length`, `order`. 작성법과 판정 규칙은 `references/ab-testing.md`. 두 개 이상을 섞으면 렌더가 거부합니다.
- 8. **렌더** — `node $SK render <폴더>`. 원고 작성 중에는 `--draft`로 자리표시·팩트 실패를 경고로 낮춰 미리 볼 수 있습니다(납품본에는 쓰지 않음).
- 9. **게이트 확인** — 콘솔과 `out/<A|B|base>/report.json`. ✗가 하나라도 있으면 원고나 카드 구성을 고쳐 다시 렌더합니다. 글씨를 줄여서 맞추지 않습니다. 카드를 나누거나 문장을 줄입니다.
- 10. **눈으로 확인** — `out/<변형>/contact-sheet.png`와 카드 PNG를 직접 열어 봅니다. 게이트는 넘침·대비를 잡지만 어색한 줄바꿈, 사진 구도, 톤은 사람이 봐야 합니다.
- 11. ⛔ **승인 ② 디자인** — contact-sheet로 승인받습니다.
- 12. **발행 패키지** — `out/<변형>/card-NN.png`(순서대로 업로드), `caption.txt`. 1080×1440은 인스타그램 공식 지원 비율(1.91:1~3:4) 중 가장 긴 세로입니다. 오디오를 붙여 올리면 릴스 탭에도 노출될 수 있습니다. A/B면 `out/experiment.md`에 게시 일시·링크와 24시간/72시간/7일 지표를 기록합니다.
- ## 원고 규칙
- - 카드 한 장에 메시지 하나. 표지는 결론이나 질문, 마지막 장은 행동 **하나**.
- - 2번 카드는 두 번째 표지입니다. 1번을 넘긴 사람에게 2번부터 다시 보일 수 있으니, 2번만 봐도 멈출 이유를 넣습니다.
- - 표지와 핵심 카드에는 가게에서 직접 찍은 사진을 씁니다. 이미지 AI 그림·합성 인물은 쓰지 않습니다.
- - 권장 6~10장(최대 20장, 10장 초과 시 경고).
- - 표지 제목 2줄 이내, 본문 2~3문장(60자 안팎). 넘치면 렌더가 실패합니다.
- - 줄바꿈은 `\n`로 직접 지정합니다. 단어 중간에서 끊기지 않게 의미 단위로 끊습니다.
- - 숫자는 `facts.md`에 있는 것만. 번호 라벨(`01 — ...`)은 검사에서 빠집니다.
- - 사진은 `sources/`에 두고 상대 경로로 씁니다. 가로 1080px 이상이어야 흐리지 않습니다.
- - AI 문체 티(“~에 대해 알아보겠습니다”, “핵심은 바로”, 과한 쉼표·영어 번역체)는 담당자가 고칩니다.
- ## 게이트
- | 게이트 | 실패 조건 |
- |---|---|
- | fact | 카드·캡션의 숫자가 `facts.md`에 없음 |
- | placeholder | `[...]` 자리표시가 남아 있음 |
- | overflow | 본문 영역이나 한 줄이 넘침 |
- | safe-zone | 글자가 가장자리 여백(좌우 72px, 상하 64px) 밖으로 나감 |
- | type-floor | 본문 26px, 메타 20px 미만 |
- | contrast | WCAG 대비 4.5(큰 글씨 3.0) 미만. 사진 위 글씨는 사진이 흰색·검은색인 최악의 경우로 계산 |
- | font | 스타일 폰트가 로드되지 않음(네트워크 문제) |
- | image | 사진 파일 없음·로드 실패(1080px 미만은 경고) |
- | A/B 규칙 | 변수 둘 이상을 바꿈, A=B, 가설·지표 누락 |
- | photo (경고) | 표지에 사진이 없음 |
- | style (경고) | "~고 있다", "~ㄹ 수 있다", 문장 앞 접속사, AI 문체 표현 |
- 경고(!)는 렌더를 막지 않지만 승인 ① 전에 0으로 만드는 것을 목표로 합니다.
- ## 스타일
- `styles/index.json`이 목록입니다. 새 스타일은 `styles/<id>.css`(토큰만 바꾸는 것이 기본)와 index 항목을 추가하고 `styles --preview`로 4장 모두 게이트를 통과하는지 확인한 뒤 씁니다. 색은 대비 게이트를 통과해야 하므로 실제 렌더로 확인합니다.
- 고객 브랜드 색은 새 스타일을 만들지 않고 `carousel.json`의 `brand.accent`(`#RRGGBB`)로 덮어씁니다. 강조색만 바뀌고, 어두운 표지·마지막 장은 스타일이 정한 색을 유지합니다. 대비 게이트에 걸리면 더 진하거나 연한 색으로 바꿉니다.
- ## 예제
- `examples/texas-bbq/` — 7장, warm-kraft, 표지 훅 A/B. `node $SK render .claude/skills/carousel-maker/examples/texas-bbq`로 전체 흐름을 확인할 수 있습니다.
README.md · README · 86 lines
- # carousel-maker
- 인스타그램 캐러셀(카드뉴스)을 **브리프 → 팩트시트 → 원고 → 스타일 선택 → A/B 변형 → 렌더·자동 검수** 순서로 만드는 Claude Code 스킬입니다. 결과물은 1080×1440 PNG(인스타그램 공식 지원 비율 중 가장 긴 세로 3:4), 캡션, A/B 실험 기록지입니다.
- 
- ## 설치
- Claude Code에 이렇게 말하면 됩니다.
- > https://github.com/min9lin9/carousel-maker 스킬 적용해줘
- ### Claude Code / AI 에이전트용 설치 절차
- 사용자가 이 저장소를 설치해 달라고 하면 아래를 그대로 실행하세요. 기본은 **현재 프로젝트에만** 설치합니다(사용자가 전역 설치를 명시한 경우에만 `~/.claude/skills/carousel-maker`).
- ```bash
- git clone --depth 1 https://github.com/min9lin9/carousel-maker.git .claude/skills/carousel-maker
- (cd .claude/skills/carousel-maker && npm install && npx playwright install chromium)
- node .claude/skills/carousel-maker/scripts/carousel.mjs styles
- ```
- 마지막 명령이 스타일 4개를 출력하면 설치 완료입니다. 새 세션에서 "캐러셀 만들어줘"라고 하면 `SKILL.md` 절차대로 진행합니다.
- 요구사항: Node.js 20 이상, 렌더할 때 인터넷(웹폰트 CDN).
- ## 무엇을 해 주나
- | 단계 | 누가 | 결과 |
- |---|---|---|
- | 브리프·팩트시트 | 사용자가 채우고 Claude가 질문으로 보완 | `brief.md`, `facts.md` |
- | 원고 | **Claude가 초안**, 담당자가 최종 문장 | `carousel.json` |
- | 승인 ① 원고 | 사람 | — |
- | 스타일 선택 | 미리보기를 보고 사람이 선택 | `style` |
- | A/B | 변수 하나 선택 | `ab` 블록 |
- | 렌더·검수 | 스크립트 | `out/<A·B>/card-NN.png`, `contact-sheet.png`, `caption.txt`, `report.json` |
- | 승인 ② 디자인 | 사람 | — |
- | 발행·측정 | 사람 | `out/experiment.md` |
- 원고는 Claude가 `brief.md`와 `facts.md`만 근거로 씁니다. 구조(설명형·숫자형·체크리스트형·비교형·현장형)를 고르고, 카드별 요지를 먼저 확인받은 뒤 초안과 표지 훅 후보를 냅니다. 표지 후보는 훅 10유형에서 고르고, 승인 전에 마감 점검을 돌립니다. 규칙은 [references/copywriting.md](references/copywriting.md), 문장 기준은 [references/writing-voice.md](references/writing-voice.md)(「처음 쓰는 사람을 위한 글쓰기 가이드」 배포용판에서 추림).
- ## 직접 쓰기
- ```bash
- SK=.claude/skills/carousel-maker/scripts/carousel.mjs
- node $SK init content/2026-W48-brisket # 프로젝트 생성
- node $SK styles --preview /tmp/styles # 스타일 비교표 styles.png
- node $SK render content/2026-W48-brisket # 렌더 + 검수 (--draft, --style <id>, --variant A|B)
- ```
- ## 스타일
- | id | 분위기 | 추천 |
- |---|---|---|
- | newsprint | 신문·에디토리얼 | 공정·역사·설명형 |
- | impact-dark | 검정 배경, 큰 굵은 글씨 | 훅이 센 주장, 숫자 강조 |
- | clean-minimal | 흰 배경, 절제된 포인트 | 체크리스트·팁 |
- | warm-kraft | 크라프트지, 간판 같은 제목 | 음식점·로컬 가게 |
- 새 스타일은 `styles/<id>.css`(색·폰트 토큰)와 `styles/index.json` 항목을 추가하면 됩니다. 고객 브랜드 색 하나만 바꿀 때는 `carousel.json`의 `brand.accent`(`#RRGGBB`)를 씁니다.
- ## A/B
- `carousel.json`에 `ab` 블록을 넣으면 A안·B안이 함께 렌더됩니다. 변수는 한 번에 **하나만** 허용됩니다: `hook`(표지 문구), `second_hook`(2번 카드), `cta`(마지막 장), `cover_image`(표지 사진), `style`, `length`(장수), `order`(순서). 자세한 내용은 [references/ab-testing.md](references/ab-testing.md).
- 
- ## 자동 검수 (실패하면 렌더 중단)
- - **fact**: 카드·캡션의 숫자가 `facts.md`에 없으면 실패 (수치 날조 방지)
- - **placeholder**: `[...]` 자리표시가 남아 있으면 실패
- - **overflow / safe-zone**: 글이 넘치거나 가장자리 여백 밖으로 나가면 실패
- - **type-floor**: 본문 26px, 메타 20px 미만이면 실패
- - **contrast**: WCAG 4.5(큰 글씨 3.0) 미만이면 실패. 사진 위 글씨는 사진이 흰색·검은색인 최악의 경우로 계산
- - **font / image**: 웹폰트 로드 실패, 사진 파일 없음
- - 경고(렌더는 계속): 표지에 사진 없음(**photo**), "~고 있다"·"~ㄹ 수 있다"·문장 앞 접속사·AI 문체 표현(**style**)
- 검수는 넘침·대비·숫자를 잡지만 문장의 어색함과 사진 구도는 못 잡습니다. 그래서 `contact-sheet.png`를 사람이 보고 승인하는 단계가 있습니다.
- ## 예제
- [examples/texas-bbq](examples/texas-bbq) — 7장, warm-kraft, 표지 훅 A/B. 수치는 일반적인 텍사스 바비큐 공정 지식이며 실제 매장 정보가 아닙니다.
- ## 라이선스
- MIT. 폰트(Pretendard, Nanum Myeongjo, Black Han Sans, Space Mono)는 번들하지 않고 CDN에서 불러오며, 각 폰트의 OFL 라이선스를 따릅니다.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.