Communitygithub.com

pierrernrd04-ai/traceo-reels

Instagram 캡션 작성 및 린팅 도구입니다. 보이는 첫 125자, 본문, 액션 요청, 검색어, 해시태그를 작성하고 린터로 검사합니다. 사용자가 '캡션 써줘', '이걸 설명해줘', 릴이나 캐러셀용 텍스트가 필요할 때 실행하세요.

traceo-reels란 무엇인가요?

이 스킬은 Instagram 릴, 캐러셀, 사진 게시물에 최적화된 캡션을 작성하고 검사하는 툴입니다. 사용자가 '캡션 써줘' 또는 '해시태그 추천해줘'라고 요청할 때 활성화되며, 'caption.py caption.txt'와 같은 스크립트 기반의 린터로 동작합니다. 주요 기능으로는 캡션의 첫 125자(사용자에게 먼저 보이는 공간)에 적절한 내용을 배치하고, 본문에 검색어를 자연스럽게 포함시키며, 하나의 명확한 액션 요청(예: 'CONTRACT 댓글 달기')을 강제합니다. 해시태그는 5개 이하로 제한하고, 2025년 12월 Instagram의 정책 변경(최대 5개)을 반영하여 'viaral', 'fyp' 같은 일반 태그를 차단합니다. 또한 캡션 내 링크 금지, 이모지 과다 사용 경고, 검색어 최적화 등 세부 규칙을 린터가 검사하여 'CAPTION READY' 상태가 아니면 게시를 보류합니다. 사용자는 린터 통과 후 캡션을 복사해 붙여넣기만 하면 됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pierrernrd04-ai/traceo-reels/tree/HEAD/studio/skills/ig-caption

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

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

문서

ig-caption

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

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

이 툴은 피드에 표시되는 그대로 캡션을 출력합니다: 처음 125자는 박스 안에, 나머지는 '더 보기' 뒤에 숨겨집니다. 다른 내용을 읽기 전에 그 박스를 먼저 읽으세요.

먼저, 이 캡션이 어떤 작업을 하는지 결정하세요

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

작업 A: 영상이 이미 시청자를 사로잡았음. 릴(Reel)은 처음 2초 안에 자체 훅(말과 화면 모두)을 전달합니다. 캡션은 두 번째 훅이 아니며, 영상과 경쟁하면 둘 다 실패합니다. 캡션의 역할은 액션 요청, 그 요청이 이해되도록 만드는 맥락, 그리고 사람들이 검색하는 단어들입니다.

작업 B: 캡션이 콘텐츠 그 자체. 사진, 단일 이미지, 루프를 여는 캐러셀 커버. 이 경우 첫 줄이 훅이며, 릴 훅과 정확히 같은 방식으로 작동합니다: 구체적이고 짧으며, 절반쯤에서 잘리지 않고 절벽에서 끝납니다.

당신이 어떤 유형을 쓰고 있는지 물어보세요. 사용자가 강력한 훅이 있는 릴을 가지고 있다면 A를 쓰고 그 이유를 말하세요.

구조

줄 1      보이는 공간 125자. 작업 A: 요청을 명확하게. 작업 B: 훅.
          절대 인사말, 해시태그, 첫 글자로 이모지를 넣지 마세요.
본문      짧은 문단, 각 문단 사이에 빈 줄 하나. 2~6개. 검색어가 여기 위치합니다.
요청      하나. 키워드 댓글, 저장, 또는 DM. 하나.
해시태그  최대 다섯 개, 맨 아래에 별도 줄로. 또는 없음.

제한은 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 검색은 캡션 텍스트를 읽습니다. 따라서 사용자가 검색되길 원하는 구절은 사람이 입력할 법한 형태로, 정상적인 문장 안에 캡션에 포함되어야 합니다. "#clientproposals"처럼 맨 아래 블록에 넣는 대신, 3번째 줄에 "Client proposals"라는 단어로 넣으세요.

두세 개의 검색어를 요청한 후 린터에 전달하세요:

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

규칙

  • 캡션에 링크를 넣지 마세요. 캡션은 클릭할 수 없습니다. 본문에 URL은 죽은 텍스트이며 "나는 이 플랫폼을 사용하지 않는다"는 인상을 줍니다. 프로필 또는 DM으로.
  • 하나의 액션 요청. 두 개의 요청은 아무것도 없는 것과 같습니다. caption.py가 이를 셉니다.
  • 키워드 요청에는 사람이 입력할 수 있는 키워드가 필요합니다. 한 단어, 공백 없음, 이모지 없음, 영상에서도 소리 내어 말하세요. CONTRACT 댓글은 작동합니다. "the contract guide" 댓글은 작동하지 않습니다.
  • 링크가 있다면 첫 번째 댓글을 별도로 작성하고, 영수증에 그 사실을 명시하세요.
  • 이모지는 구두점으로, 장식이 아닙니다. 린터는 100자당 4개를 초과하는 경우 플래그를 지정합니다.
  • 대체 텍스트는 20초의 가치가 있습니다. 캐러셀과 사진의 경우 대체 텍스트를 작성하세요. 화면 리더기와 Instagram이 읽습니다.

프로세스

  1. 작업 A 또는 작업 B를 결정하고 말하세요.
  2. 초안을 작성합니다.
  3. /ig-human으로 검사합니다. 캡션은 짧기 때문에, 여기서의 형편없는 내용은 다른 곳보다 더 눈에 띕니다.
  4. 사용자의 검색어와 함께 caption.py를 실행합니다. 모든 FAIL을 수정하세요. 모든 WARN에 대해 침묵하지 말고 소리 내어 결정하세요.
  5. 복사 가능한 블록을 출력한 후, 영수증을 출력합니다:
CAPTION READY
job:        A - 릴이 훅을 전달함
visible:    125자 중 118자 사용 (잘리기 전)
ask:        하나, CONTRACT 댓글
hashtags:   3
search:     "client proposals" 3번째 줄, "agency pricing" 5번째 줄
linter:     READY

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

Individual skills in this repo

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

관련 스킬