// AI에게 통째로 맡기기
이 가이드 전체를 복사해서
AI 대화창에 붙여넣으세요.
AI가 준비물부터 물어보고 목차 순서대로 같이 진행해요.
- 준비물클로드 코드 (클로드 앱에서도 일부 가능)
- 준비물내 릴스 대본이나 캡션 3개
- 준비물인사이트 화면 (성과 분석할 때)
- 비용스킬은 무료(MIT 공개). 클로드 사용 요금만 들어요
- 시간설치 5분, 말투 파일 10분
// 30초 요약
- 01무엇을 해 주고 무엇은 안 해 주나13개가 하는 일과 직접 올리지 않는 이유를 봐요
- 02설치하기주소 한 줄을 붙여넣거나 명령어로 깔아요
- 03내 말투 파일 만들기모든 스킬이 읽는 voice.md를 10분 만에 채워요
- 04첫 실행/ig-reel로 첫 줄 후보와 점수를 받아요
- 05이번 주 올릴 거리 짜기/ig-plan으로 요일·시간·형식·말 걸 계정까지 정해요
- 06지난주 성과로 다음 주 대본 짜기/ig-audit 결과를 계획과 대본으로 이어요
- 07스킬 13개 전체 사용법명령마다 언제 쓰고 무엇을 넣는지 봐요
- 08매주 월요일 한 번 돌리는 순서일주일 계획을 한 자리에서 끝내는 순서예요
무엇을 해 주고 무엇은 안 해 주나
instagram-agent-skill은 인스타 계정 운영에 쓰는 클로드 스킬 13개 묶음이에요. 제이크 신카리올(Jake Schincariol)이 MIT 라이선스로 공개했고, 가입이나 API 키 없이 무료로 써요. 2026년 11월 12일 기준 깃허브 별은 6천 개를 넘었어요.
스킬은 글을 써 주는 것까지만 해요. 릴스 대본, 첫 줄(후킹), 캡션, 한 주 계획, 성과 분석, 댓글 답글, DM 문구를 만들어 주고, 올리는 건 내가 해요. README에 이렇게 적혀 있어요.
- 인스타에 게시·댓글·팔로우·DM을 자동으로 하는 브라우저 자동화나 외부 도구는 인스타 이용약관 위반이라 계정이 제한될 수 있어요.
- 그래서 모든 스킬은 복사해서 붙여넣을 글로 끝나요. 내가 확인하고 올려요.
- 내가 주지 않은 숫자나 성과는 지어내지 않아요. 숫자가 필요한데 없으면
{{your number}}자리 표시를 남기고 알려 줘요.
13개 중 5개에는 실제로 돌아가는 파이썬 도구가 들어 있어요. 내 컴퓨터에서만 돌고 인터넷으로 아무것도 보내지 않아요.
| 도구 | 하는 일 |
|---|---|
hookscore.py |
첫 줄 후보에 점수를 매기고 순위를 내요 |
beats.py |
대본을 초 단위로 나누고 늘어지는 구간을 짚어 줘요 |
caption.py |
피드에서 '더 보기' 전에 보이는 125자를 보여 주고 캡션을 점검해요 |
humanize.py, detect.py |
AI가 쓴 티(긴 줄표, 상투어, 보이지 않는 글자)를 지우고 점수를 매겨요 |
swipe.py |
남의 릴스를 그 계정 평소 조회수 대비 몇 배 나왔는지로 순위를 매겨요 |
설치하기
가장 쉬운 방법은 클로드 코드에 아래 내용을 그대로 붙여넣는 거예요. 저장소 README에 적힌 설치 문구예요.
https://github.com/Jakeschincariol/instagram-agent-skill
Install this skill, then confirm /ig-reel works.
직접 깔고 싶으면 터미널에 아래를 넣어요. 첫 줄은 스킬 폴더가 없을 때를 대비한 거예요.
git clone https://github.com/Jakeschincariol/instagram-agent-skill.git
mkdir -p ~/.claude/skills
cp -r instagram-agent-skill/skills/ig-* ~/.claude/skills/
플러그인으로 깔 수도 있어요. 클로드 코드 입력창에 한 줄씩 넣어요.
/plugin marketplace add Jakeschincariol/instagram-agent-skill
/plugin install instagram-agent
성공하면 첫 번째 방법으로 깔았다면 클로드가
/ig-reel이 동작하는지까지 확인해 줘요. 직접 깔았다면 클로드 코드를 새로 열고/ig-reel을 쳐 보세요.
안 될 때 새 컴퓨터에서
cp가 "No such file or directory"로 실패했다는 보고가 있어요.~/.claude/skills폴더가 아직 없어서예요. 위 순서처럼mkdir -p ~/.claude/skills를 먼저 넣으면 돼요. 윈도우 PowerShell이면New-Item -ItemType Directory -Force "$HOME\.claude\skills"뒤에Copy-Item -Recurse instagram-agent-skill\skills\ig-* "$HOME\.claude\skills\"를 넣어요.
클로드 앱(웹·데스크톱)에서 쓰려면 스킬 올리기 메뉴가 스킬 하나당 압축 파일 하나를 받아요. 깃허브에서 통째로 받은 압축 파일은 거절되고, skills 안의 ig- 폴더를 하나씩 따로 압축해 올리면 된다고 해요. 다만 앱에서는 파이썬 도구 5개가 돌지 않아서 점수 매기기는 빠져요.
내 말투 파일 만들기
13개 스킬이 모두 voice.md라는 말투 파일을 먼저 읽어요. 릴스는 내가 소리 내어 말해야 해서, 이 파일이 비어 있으면 내 입에 안 붙는 대본이 나와요.
가장 빠른 방법은 내가 올린 릴스 대본이나 캡션 3개를 주고 만들어 달라고 하는 거예요. 템플릿에도 이 방법이 손으로 채우는 것보다 낫다고 적혀 있어요.
아래는 내가 올린 릴스 대본 3개야. 이걸 보고 instagram-agent-skill의 templates/voice.md 형식에 맞춰 내 voice.md를 써서 ~/.claude/instagram/voice.md에 저장해 줘. 결과물은 한국어로 써 줘.
1. <첫 번째 릴스 대본>
2. <두 번째 릴스 대본>
3. <세 번째 릴스 대본>
주황색으로 표시한 부분에 내 대본을 넣어요. 파일에는 이런 칸이 있어요.
- 나는 누구이고 누구에게 말하나 (예: "사진 작가" 말고 "200만 원 아래로 받는 사진 작가")
- 자주 쓰는 말, 절대 안 쓰는 말, 이모지를 쓰는지
- 내가 믿는 주장 3~5개 (좋은 릴스가 여기서 나온다고 해요)
- 공개해도 되는 실제 숫자와 사례
- 댓글 키워드와 그 키워드에 보낼 것
'공개해도 되는 숫자와 사례'가 비어 있으면 모든 초안에 {{your number}}가 들어가요. 스킬이 숫자를 지어내지 않기 때문이에요.
첫 실행, 후킹 3개 뽑고 점수 보기
/ig-reel은 아이디어 하나를 릴스로 바꿔 줘요. 후킹 공식 26개 중 맞는 3개를 골라 첫 줄 후보를 쓰고, 점수를 매긴 뒤 이긴 후보로 대본까지 써요.
/ig-reel <릴스로 만들고 싶은 아이디어 한 줄. 예: 견적서 쓰는 시간을 5시간에서 20분으로 줄인 방법>. 결과는 한국어로 보여 줘.
후킹 공식은 이런 것들이에요. 26개 전체는 저장소의 hooks.json에 템플릿·예문과 함께 있어요.
| 번호 | 공식 | 예문 (원문을 옮김) |
|---|---|---|
| 1 | Cost Confession (손해 고백) | 계약서 조항 하나가 빠져서 1만 8천 달러를 날렸어요 |
| 3 | Nobody Tells You (아무도 안 알려 주는 것) | 첫 릴스 30개는 원래 망하는 게 정상이라는 걸 아무도 안 알려 줘요 |
| 5 | Time Collapse (시간 단축) | 견적서에 5시간 걸리던 게 이제 20분이에요 |
| 9 | The Steal (가져다 쓰세요) | 2년 걸려 만든 네 줄짜리 후속 메시지, 그대로 가져가세요 |
| 18 | Cold Open Demo (바로 시연) | 경쟁사 캡션을 여기에 붙여넣으면 무슨 일이 생기는지 보세요 |
점수는 이렇게 나와요. README에 실린 실제 출력이에요.
HOOK RANKING
-> 85.6 STRONG Nobody tells you that your first 30 reels are supposed to f...
weakest: SPECIFICITY (75)
81.4 STRONG I lost $18,000 because of one missing contract.
weakest: ADDRESS (70)
54.4 OK Stop scrolling if you want to grow on Instagram in 2026 🔥
dealbreaker: Opens with "stop scrolling".
9.6 WEAK Hey guys, today I wanted to talk about content strategy
dealbreaker: Greeting.
맨 위 후보가 50점 아래면 아직 후킹이 없는 거라고 스킬 문서에 적혀 있어요. 그다음 beats.py가 대본을 초 단위로 나눠서 3초를 넘는 후킹, 4초 넘게 화면이 안 바뀌는 구간을 짚어 줘요.
점수를 너무 믿지는 마세요. 만든 사람이 직접 잰 결과를 README에 공개했어요. 일부러 못 쓴 후킹은 잘 걸러냈지만(AUC 0.83), 같은 크리에이터의 잘된 영상과 안된 영상을 가르는 힘은 동전 던지기 수준(AUC 0.56)이었어요. 그래서 "뻔히 약한 첫 줄을 찍기 전에 버리는 용도"로 쓰라고 해요.
안 될 때 한국어 첫 줄은 점수가 제대로 안 나와요. 현재 main 버전은 단어를 영어 알파벳으로만 세서, 영어가 아닌 글자는 계산에서 거의 빠진다고 보고됐어요(고치는 PR #11이 아직 반영 전). 한국어 릴스라면 점수 대신 공식 고르기와 대본 쓰기만 쓰고, 점수는 참고하지 마세요.
안 될 때 윈도우에서 도구가
UnicodeEncodeError로 멈추는 경우가 보고됐어요. 출력에 이모지가 있을 때 생겨요. 클로드에게 "파이썬을 돌릴 때 앞에 PYTHONIOENCODING=utf-8을 붙여 줘"라고 하면 돼요.
안 될 때 플러그인으로 깔았는데
hookscore.py를 못 찾는다는 보고도 있어요. 스킬 문서가 스킬 폴더 안에서 실행하는 것처럼 적혀 있어서예요. 클로드에게 "스크립트는 플러그인 설치 폴더의 skills/ig-reel 안에 있어"라고 알려 주면 돼요.
여기까지면 첫 줄 후보와 대본을 받을 수 있어요. 이번 주 계획 짜기, 지난주 성과로 다음 주 대본 짜기, 13개 전체 사용법과 월요일 순서는 아래에 있어요.
여기부터 잠겨 있어요
이메일만 남기면
나머지가 바로 열려요
한 번 남기면 이 사이트의 모든 자료가 열려요. 무료예요.
열리는 내용이번 주 올릴 거리 짜기지난주 성과로 다음 주 대본 짜기스킬 13개 전체 사용법매주 월요일 한 번 돌리는 순서
// 공식 출처
- instagram-agent-skill 공식 저장소 README
- 후킹 공식 26개 (hooks.json)
- /ig-reel 스킬 문서
- /ig-plan 스킬 문서
- /ig-audit 스킬 문서
- /ig-viral 스킬 문서
- /ig-caption 스킬 문서
- 말투 파일 템플릿 (voice.md)
- 깃허브 이슈 #59: 새 컴퓨터에서 수동 설치가 실패, 클로드 앱 업로드 방법
- 깃허브 PR #58: 윈도우에서 이모지가 든 출력이 멈추는 문제
- 깃허브 이슈 #46: 플러그인 설치 후 스크립트 경로를 못 찾는 문제, 캐러셀이 PDF로 나오는 문제
- 깃허브 PR #11: 영어가 아닌 글자는 점수 계산에서 거의 빠지는 문제
- 깃허브 이슈 #44: 실제 계정에서 몇 주 써 본 사용자의 보고
2026년 11월 12일, Jakeschincariol/instagram-agent-skill 저장소 main 브랜치(플러그인 1.0.0) 기준 · 메뉴 위치나 화면은 바뀔 수 있어요.
// 이어서 볼 자료
클로드로 AI 애니메이션 릴스 만드는 법 (데스크톱 앱 세팅부터 수정 요청까지)
클로드로 만든 애니메이션 릴스를 보고 따라 하고 싶은데 어디서부터 세팅할지 막막했다면, 클로드 데스크톱 앱에 영상 폴더를 연결하고 lemo-opuscar 스킬을 설치하세요. 주제를 한 줄로 말하면 대본·음성·장면 애니메이션·자막까지 만들어 주고, 마음에 안 드는 곳은 말로 고치면 돼요.
읽는 데 10분
클로드에게 단계 대신 생각하는 법을 가르치는 '콘텐츠 원칙' 스킬 만들기
클로드에게 잘된 영상과 훅을 잔뜩 보여 줘도 '훅 → 넘버링 → CTA' 같은 뼈대만 따라 써서 막막했다면, 원칙과 그 이유를 담은 스킬을 직접 만들어 보세요. 훅, 호기심 이어가기, 구체적으로 쓰기, 첫 줄로 다음 줄 읽게 만들기를 기준으로 초안을 쓰고 기존 원고도 점검해 줘요.
읽는 데 9분
유튜브 강의를 클로드가 보고 배워 스킬로 만드는 법 (watch)
좋은 유튜브 강의를 봐도 며칠 지나면 다 잊어서 막막했다면, 클로드 코드에 watch 스킬을 깔고 영상 주소를 넣어 보세요. 클로드가 장면과 자막을 읽고, 배운 방법을 계속 꺼내 쓰는 스킬 파일로 저장해 줘요.
읽는 데 8분
클로드 코드에 AI 개발팀을 통째로 넣는 플러그인, 에브리띵 클로드 코드(ECC) 설치·활용법
클로드 코드에 스킬을 하나씩 찾아 까느라 막막했다면 에브리띵 클로드 코드(ECC)를 두 줄로 설치하세요. 계획·코드 리뷰·보안 점검 에이전트와 마케팅·콘텐츠·시장조사 스킬까지 한 번에 들어와요.
읽는 데 8분
