Communitygithub.com

ig-caption

Instagram 캡션 작성 및 린트 도구입니다. 사용자가 "캡션 써 줘", "설명에 뭐 넣지?"라고 말하거나 릴/캐러셀에 텍스트가 필요할 때 사용합니다.

ig-caption란 무엇인가요?

이 스킬은 Instagram 게시물(릴, 사진, 캐러셀)의 캡션을 작성하고 린트하는 전문 도구입니다. 사용자의 음성 프로필(`~/.claude/instagram/voice.md`)을 읽거나 추론하여 일관된 톤을 유지하며, 캡션의 목적(비디오 훅 보조 vs. 캡션 자체가 콘텐츠)을 먼저 결정합니다. 125자 제한의 보이는 부분, 본문, 하나의 명확한 액션 요청, 최대 5개의 해시태그를 생성합니다. Instagram이 2025년 12월 해시태그를 5개로 제한하고 검색이 캡션 텍스트를 읽는 변화를 반영하여, 해시태그보다 검색어를 본문에 자연스럽게 포함시키는 것을 우선시합니다. `python3 caption.py` 스크립트로 캡션을 검증하고(실패 항목 수정, 경고 항목은 사용자와 논의) 최종 레시피를 출력합니다. Claude Code, Cursor, Codex 등 AI 에이전트 환경에서 실행됩니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ilijachrchev/skills/tree/HEAD/skills/instagram-agent-skill/ig-caption

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

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

문서

ig-caption은(는) 무엇을 하나요?

이 폴더에는 하나의 도구가 있으며 다음과 같이 실행합니다:

python3 caption.py caption.txt
python3 caption.py caption.txt --keywords "client proposals,agency pricing"

캡션을 피드에 표시되는 방식 그대로 출력합니다: 처음 125자는 박스 안에, 나머지는 탭 뒤에 표시됩니다. 다른 내용을 쓰기 전에 그 박스를 먼저 읽으세요.

음성(Voice)

~/.claude/instagram/voice.md 파일이 있으면 읽고 그 스타일로 작성하세요: 사용자가 실제로 사용하는 단어, 절대 하지 않을 표현, 이모지와 욕설 처리 방식, 그리고 자신의 이름을 내걸어도 좋다고 생각하는 증거. 파일이 없으면 사용자가 게시한 내용 중 두세 가지를 요청하고, 그로부터 음성을 추론한 후 파일을 작성하겠다고 제안하여 다음 스킬이 활용할 수 있도록 하세요.

먼저, 이 캡션의 역할을 결정하세요

이 결정을 건너뛰면 캡션이 망가집니다.

작업 A: 비디오가 이미 시청자를 사로잡았음. 릴은 처음 2초 안에 자체 훅(음성 및 화면)을 전달합니다. 캡션은 두 번째 훅이 아니며, 비디오와 경쟁하면 둘 다 실패합니다. 캡션의 역할은 요청, 요청을 이해할 수 있게 하는 맥락, 그리고 사람들이 검색하는 단어입니다.

작업 B: 캡션이 콘텐츠 그 자체. 사진, 단일 이미지, 루프를 여는 캐러셀 커버. 여기서 첫 줄은 훅이며, 릴 훅과 똑같이 작동합니다: 구체적이고, 짧고, 중간에 끊기지 않고 절벽에서 잘립니다.

지금 어떤 유형을 작성 중인지 물어보세요. 사용자가 강력한 훅이 있는 릴을 가지고 있다면 A 유형을 작성하고 이유를 설명하세요.

구조

1번 줄      125자의 보이는 공간. 작업 A: 요청을 간결하게.
            작업 B: 훅.
            인사말, 해시태그, 첫 글자 이모지 절대 금지.
본문        짧은 단락, 각 단락 사이에 한 줄 공백. 2~6개.
            검색어는 여기에 위치합니다.
요청        하나. 키워드 댓글, 저장, DM 중 하나.
해시태그    최대 5개, 마지막 줄에 별도로, 또는 없음.

제한은 2,200자이며 거의 모든 캡션에 2,200자가 필요하지 않습니다. 탭을 유도하고 600자를 제공하는 캡션이 1,800자를 제공하는 캡션보다 낫습니다.

해시태그에 대한 솔직한 이야기

해시태그는 더 이상 도달 범위 레버가 아니며, 플랫폼도 제품 변경으로 이를 명확히 밝혔습니다. Instagram은 2025년 12월 18일 게시물당 해시태그를 5개로 제한했으며, 30개에서 줄이면서 "더 적은 수(최대 5개)의 타겟 해시태그를 사용하는 것이 많은 일반 해시태그를 사용하는 것보다 성과가 좋다"고 크리에이터에게 알렸습니다. Adam Mosseri는 이미 2025년 2월에 해시태그가 도달 범위 증가에 효과가 없으며, 분배 레버가 아닌 라벨이라고 말했습니다.

따라서: 최대 5개, 구체적이며 주제 라벨로 사용하세요. 사용자가 노트 앱에 저장한 20개의 해시태그 블록은 이제 죽은 무게이며 린터가 실패 처리합니다.

#viral, #fyp, #explorepage, #foryou는 아무것도 설명하지 않습니다. 잘라내세요.

검색어가 이제 해시태그보다 중요합니다

Instagram 검색은 캡션 텍스트를 읽습니다. 따라서 사용자가 검색되길 원하는 구문은 사람이 입력할 구문 그대로, 정상적으로 읽히는 문장 안에 캡션에 포함되어야 합니다. "Client proposals"는 3번째 줄에 단어로, 마지막 블록에 "#clientproposals"가 아니라.

해당 용어를 두세 개 요청한 후 린터에 전달하세요:

python3 caption.py draft.txt --keywords "client proposals,agency pricing"

규칙

  • 캡션에 링크 금지. 캡션은 클릭할 수 없습니다. 본문의 URL은 "이 플랫폼을 사용하지 않습니다"라고 말하는 죽은 텍스트입니다. 바이오 또는 DM.
  • 하나의 요청. 두 개의 요청은 없는 것과 같습니다. caption.py가 개수를 셉니다.
  • 키워드 요청은 사람이 입력할 수 있는 키워드여야 함. 한 단어, 공백 없음, 이모지 없음, 비디오에서도 소리 내어 말하세요. Comment CONTRACT는 작동합니다. Comment "the contract guide"는 작동하지 않습니다.
  • 링크가 있으면 첫 번째 댓글을 별도로 작성하세요. 레시피에 명시하세요.
  • 이모지는 장식이 아닌 구두점으로 사용. 린터는 100자당 4개를 초과하면 플래그를 표시합니다.
  • 대체 텍스트는 20초의 가치가 있습니다. 캐러셀과 사진의 경우 작성하세요. 스크린 리더와 Instagram이 읽습니다.

루프

  1. 작업 A 또는 작업 B를 결정하고 말합니다.
  2. 초안을 작성합니다.
  3. /ig-human을 실행합니다. 캡션은 짧기 때문에, 여기서의 오류는 다른 곳보다 더 두드러집니다.
  4. 사용자의 검색어와 함께 caption.py를 실행합니다. 모든 FAIL을 수정합니다. 모든 WARN에 대해 조용히 결정하지 않고 소리 내어 결정합니다.
  5. 복사 준비가 된 블록을 출력한 다음 레시피를 출력합니다:
CAPTION READY
작업:        A - 릴이 훅을 전달
보이는 부분:  절단 전 125자 중 118자 사용
요청:        하나, CONTRACT 댓글
해시태그:    3
검색어:      "client proposals" 3번째 줄, "agency pricing" 5번째 줄
린터:        READY

아무것도 게시되지 않습니다. 사용자가 붙여넣습니다.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

관련 스킬