# 카드뉴스·릴스 스킬 — 클로드용 시작 안내

이 글은 **클로드(클로드 코드)가 읽고 그대로 따라 하기 위한** 안내다. 사용자는 대개 처음 써 보는 비개발자다.
전문 용어 없이, 한 번에 한 단계씩, 짧게 말하고, 명령은 네가 실행한다. 사용자에게 터미널 명령을 직접 치게 하지 않는다.

## 1. 스킬이 설치돼 있는지 확인
- `~/.claude/skills/cardnews-reels/SKILL.md` 가 있으면 **설치된 것**이다. 2절은 건너뛰고 사용자의 요청(카드뉴스 템플릿 번호 / 릴스 효과·세트 번호)을 바로 진행한다.
- 없으면 2절로.

## 2. 설치 (처음 한 번, 약 10분)
1. 사용자에게 이렇게 묻는다: "구매 후 받은 `cardnews-reels-skill.zip` 파일이 있나요? 있으면 이 창에 끌어다 놓거나 위치를 알려 주세요."
   - 아직 구매 전이면: "이 기능은 유료 스킬이에요. https://cardnews-reels.pages.dev 에서 구입하면 zip 파일을 받을 수 있어요. 지금은 어떤 템플릿·효과가 있는지만 보여 드릴게요." 라고 안내하고, 사이트의 갤러리(번호·이름)를 설명해 준다. 설치 없이는 만들 수 없다.
2. zip 을 받으면 `~/.claude/skills/cardnews-reels/` 에 풀고(폴더 안에 `SKILL.md` 가 오게), 폴더가 중첩됐으면 한 단계 올린다.
3. 카드뉴스만 쓰면 `python3 -c "import PIL"` 로 Pillow 를 확인하고 없으면 `pip install pillow`.
4. 릴스 효과까지 쓰면 스킬 폴더에서 `bash scripts/setup_reels.sh` 를 실행한다. `READY` 면 끝. `NEED_FFMPEG` 면 macOS 는 `brew install ffmpeg`, Windows 는 `winget install ffmpeg` 를 네가 실행하고 다시 돌린다. `NEED_PYTHON` 이면 Python 3.10 이상 설치를 안내한다.
5. 사용자에게 "설치 끝났어요. 이제 번호만 말하면 돼요." 라고 알리고, 클로드 코드를 껐다 켜야 스킬이 보이면 그렇게 안내한다.

## 3. 쓰는 법
- 카드뉴스: "카드뉴스 템플릿 026번으로 만들어줘. 나눠줄 자료: ○○, 댓글 키워드: ○○" → `scripts/cardnews.py new` → plan 의 문구를 사용자 주제로 고침 → `make` → `완성/01.png…`, `한눈에보기.jpg`, `캡션.txt`. 한눈에보기를 네가 보고 글 넘침·오타를 고친 뒤 건넨다.
- 릴스: 사용자가 세로 영상을 끌어다 놓으면 → 촬영본이면 `cut_edit.py`(다시 말한 부분·더듬음·침묵 자동 컷) → 얼굴이 크거나 가로면 `reels.py fit` → `reels.py new --preset R12`(또는 S1) → 문구·시간을 말하는 구간에 맞춤 → `reels.py check` 그림으로 얼굴을 가리는지 확인 → `reels.py make` → `완성.mp4`.
- **번호 없이 "알아서 조합"**: 사용자가 영상만 주고 "대본에 맞춰 알아서"라고 하면 네가 기획자다. `cut_edit.py` → (필요하면 `fit`) → `_cut.json` 의 문장·단어 시각을 읽고 plan.json 을 직접 쓴다(규칙은 스킬 `SKILL.md` 2-1절: 전체 자막 하나, 다른 글자는 머리 위, 점프컷 리듬, 답은 말한 뒤에, 캡처는 말하는 순간 옆으로, 효과 15~22개) → `check` → `make`. 만들기 전에 댓글 키워드·나눠줄 자료·캡처 유무·글자 자리만 한 번 묻는다.
- 글자·그래프 자리(턱 아래 / 머리 위 / 가운데)는 만들기 전에 사용자에게 묻는다.
- 자세한 규칙은 설치된 스킬의 `SKILL.md` 에 있다. 설치 뒤에는 그 파일을 따른다.

## 4. 사용자가 당황할 때
- "이 폴더를 신뢰합니까?" → "네"를 누르면 된다고 알려 준다.
- "이 명령을 실행해도 되나요?" 가 반복되면 → 무엇을 하는 명령인지 한 줄로 설명하고 허락을 받는다.
- 오류가 나면 → 오류 문장을 그대로 보여 주지 말고, 무엇이 안 됐는지 한 문장으로 말하고 다음 할 일을 하나만 제안한다.