1-5 · AI 스킬

무료 인스타그램 AI 스킬 설치·활용 가이드

클로드 코드에 인스타그램 AI 스킬을 설치하고 쓰는 법.

인스타그램 · 콘텐츠 제작읽는 데 9분업데이트 2026.11.04
이 자료의 순서 11
  1. 01. 이 스킬은 무엇인가요?
  2. 02. 준비물
  3. 03. 설치하기 — 가장 쉬운 방법
  4. 04. 릴스 대본 만들어보기
  5. 05. 캡션도 만들어보기
  6. 06. 다른 명령어는 무엇이 있나요?
  7. 07. 내 말투로 작성하게 만들기
  8. 08. 설치가 잘 안 될 때
  9. 09. 설치 후 체크리스트
  10. 10. 공식 출처
  11. 이 도구가 마음에 드셨나요?
인스타그램 릴스 대본과 캡션을 AI로 만들고 싶다면?
개발자 Jake Schincariol이 GitHub에 무료 공개한 Instagram Agent Skill을 Claude Code에 설치해 사용하는 초보자용 가이드입니다.
별도 인스타그램 계정 연결 없이 릴스 대본·캡션 초안을 만들어볼 수 있습니다.

01. 이 스킬은 무엇인가요?

Instagram Agent Skill은 Claude Code에서 인스타그램 콘텐츠 제작·분석을 도와주는 13개 스킬 묶음입니다.

  • 릴스 주제에 맞는 후킹과 대본 작성
  • 인스타그램 캡션 작성 및 점검
  • 기존 인기 콘텐츠의 구조 분석 지원
  • 콘텐츠 캘린더와 프로필 개선안 작성
  • 작성한 글의 어색한 AI 표현 점검

중요: 스킬 자체는 MIT 라이선스로 무료 공개되어 있지만, Claude Code 이용 요금은 별개입니다. 또한 영상 생성·자동 게시 도구가 아닙니다. 최종 업로드는 직접 진행해야 합니다.

개발자 공식 저장소: GitHub — Instagram Agent Skill


02. 준비물

  • 컴퓨터(Windows 또는 Mac)
  • Claude Code를 사용할 수 있는 환경
  • Claude Pro·Max·Ultra 등의 유료 구독 또는 유료 API 사용 환경
  • 스킬을 설치할 수 있는 Claude Code 세션

이 가이드는 Claude Code를 기준으로 합니다. 일반 Claude 웹 채팅에 /plugin 명령을 입력하는 방식이 아닙니다.

먼저 요금을 확인하세요.

  • Instagram Agent Skill: 스킬 자체는 무료 오픈소스입니다.
  • Claude Free: 무료 채팅 계정만으로는 이 가이드의 Claude Code 설치·실행 방식 이용 불가
  • Claude Pro·Max·Ultra: Claude Code 사용 가능(요금제별 사용량 제한 적용)
  • Claude API: 별도 종량제 비용으로 Claude Code 사용 가능

즉, 무료 스킬 ≠ 무료 실행 환경입니다. 유료 구독이나 API 비용이 발생할 수 있으니 설치 전에 확인하세요.

공식 안내: Anthropic — Claude Code 이용 조건

Claude Code가 처음인가요? 먼저 Claude Code 공식 설치 가이드에서 운영체제별 설치 및 로그인 과정을 완료하세요. Claude Code가 실행되고 명령을 받을 수 있는 상태라면 다음으로 넘어가면 됩니다.

03. 설치하기 — 가장 쉬운 방법

아래 두 명령은 Windows PowerShell이나 웹브라우저가 아니라, 실행 중인 Claude Code의 대화 입력창에 각각 입력합니다.

STEP 1. 플러그인 마켓플레이스 추가

Plain Text
/plugin marketplace add Jakeschincariol/instagram-agent-skill

명령을 입력하고 완료 결과를 확인합니다.

STEP 2. 인스타그램 스킬 설치

Plain Text
/plugin install instagram-agent

설치가 끝나면 안내 메시지를 확인하세요.

STEP 3. 스킬 인식 확인

Claude Code 입력창에 /ig를 입력해 스킬 목록이 표시되는지 확인합니다.

목록이 나타나지 않으면 Claude Code의 새 세션을 열어 다시 확인하세요.

플러그인 명령이 인식되지 않거나 설치가 실패한다면, 공식 GitHub README의 설치 안내와 Claude Code 플러그인 공식 문서를 확인하세요.

주의: 외부 개발자가 공개한 오픈소스 스킬입니다. 설치·실행 권한 요청을 확인하고, 익숙하지 않은 코드를 무조건 허용하지 마세요. 이 가이드는 실행 파일의 안전성을 독립적으로 보증하지 않습니다.


04. 릴스 대본 만들어보기

설치가 끝났다면 다음 명령을 입력해보세요.

Plain Text
/ig-reel

주제: 집에서 아이스라떼를 맛있게 만드는 3가지 팁

대상: 홈카페에 관심 있는 초보자
길이: 30초
형식: 손과 재료를 보여주는 튜토리얼 릴스
톤: 쉽고 친근한 한국어 존댓말

첫 3초 후킹 3개, 추천 대본,
장면별 진행 흐름, 화면 자막을 만들어줘.
과장된 성과 보장은 제외해줘.

결과를 확인하면서 후킹의 구체성, 대본 길이, 근거의 정확성, 본인의 말투를 검토하세요.

스킬은 대본을 자동으로 작성하지만, 실제 촬영과 편집은 직접 해야 합니다.

05. 캡션도 만들어보기

Plain Text
/ig-caption

아래 릴스 대본을 기반으로
한국어 인스타그램 캡션을 작성해줘.

대상: 홈카페를 처음 시작하는 사람
목적: 레시피 저장 유도
톤: 쉽고 친근한 한국어 존댓말

첫 문장은 읽고 싶게 만들되 과장하지 말고,
본문은 짧은 문단으로 나눠줘.
마지막 행동 유도는 한 가지만 제안해줘.

[여기에 완성한 릴스 대본 붙여넣기]

작성된 캡션을 인스타그램에 붙여넣기 전에 줄바꿈·문구·사실관계·해시태그를 직접 확인하세요.


06. 다른 명령어는 무엇이 있나요?

  • /ig-viral — 관심 분야의 인기 릴스 조사 및 구조 분석을 지원
  • /ig-plan — 주간 콘텐츠 계획 작성
  • /ig-carousel — 카드뉴스 기획
  • /ig-profile — 프로필 점검 및 개선안
  • /ig-human — AI 같은 표현과 문체 점검
  • /ig-repurpose — 기존 콘텐츠 재활용

전체 명령과 상세 기능은 공식 GitHub 저장소에서 확인할 수 있습니다.

특히 /ig-viral 주의: 이 스킬이 인스타그램의 모든 릴스 조회수를 실시간으로 수집하거나 직접 계정 데이터를 읽는다는 의미는 아닙니다. 접근 가능한 자료나 사용자가 제공한 데이터를 토대로 분석하며, 확인되지 않은 수치나 사례는 검증해야 합니다.


07. 내 말투로 작성하게 만들기

이 프로젝트에는 templates/voice.md라는 말투 설정용 템플릿이 있습니다.

공식 안내에 따르면 이 템플릿을 사용자 설정 파일인 ~/.claude/instagram/voice.md로 복사하고 본인의 말투를 작성할 수 있습니다.

초보자에게는 아래 방법을 추천합니다.

  1. GitHub 공식 저장소를 엽니다.
  2. templates/voice.md 파일을 확인합니다.
  3. Claude Code에 “공식 voice.md 템플릿을 기준으로 내 말투 설정을 도와줘”라고 요청합니다.
  4. 이전에 작성한 릴스 대본 3개를 참고자료로 제공합니다.
  5. 파일을 만든 뒤 다시 /ig-reel로 테스트합니다.

복사용 요청문

Plain Text
Instagram Agent Skill의 공식 저장소에 있는
templates/voice.md 구조를 확인해줘.

내가 제공하는 릴스 대본 3개를 분석해
내 말투와 콘텐츠 제작 원칙을 정리하고,
~/.claude/instagram/voice.md에 반영해줘.

한국어 존댓말을 사용하고
과장된 후킹과 근거 없는 통계를 피하도록 해줘.

파일을 수정하기 전 내용과 경로를 먼저 보여줘.

참고: ~는 사용자 홈 디렉터리를 의미합니다. Windows와 Mac의 실제 경로는 다르므로, 경로를 직접 입력하기보다는 Claude Code가 환경을 확인하도록 하는 편이 안전합니다.


08. 설치가 잘 안 될 때

Q. /plugin 명령이 인식되지 않아요.

일반 Claude 웹 채팅이나 운영체제 터미널이 아닌 Claude Code 대화창인지 확인하세요. 사용하는 Claude Code 버전의 플러그인 지원 여부와 공식 플러그인 문서를 확인하세요.

Q. /ig-reel이 보이지 않아요.

마켓플레이스 추가와 플러그인 설치가 각각 완료됐는지 확인합니다. 새 세션에서 다시 명령어를 입력해보고, 오류 메시지가 남으면 그대로 확인하세요.

Q. 스킬은 무료인데 결제가 필요한가요?

스킬 자체는 무료(MIT 라이선스)지만 Claude 무료 채팅 계정만으로 Claude Code 플러그인을 실행할 수는 없습니다. Claude Pro·Max·Ultra 등의 유료 구독 또는 별도 사용료가 발생하는 Claude API 환경이 필요합니다. 유료 구독에도 사용량 제한이 있습니다.

Q. 인스타그램 계정을 연결해야 하나요?

이 프로젝트의 대본·캡션 작성 기능은 인스타그램 로그인이나 API 키 연결을 전제로 하지 않습니다. 실제 계정의 비공개 데이터 자동 수집이나 자동 게시 기능을 의미하지 않습니다.

Q. 일반 Claude 채팅에서도 사용할 수 있나요?

공식 저장소는 개별 SKILL.md 내용을 채팅에 붙여넣는 사용법도 설명합니다. 다만 Claude Code에서 실행하는 로컬 Python 도구까지 동일하게 사용할 수는 없습니다. 이 가이드는 완전한 스킬 활용을 위해 Claude Code 설치를 기준으로 설명했습니다.

Q. 결과물이 무조건 바이럴되나요?

아닙니다. 후킹과 대본 구조를 보완해주는 제작 보조 도구입니다. 조회수·팔로워·매출을 보장하지 않습니다.


09. 설치 후 체크리스트

Claude Code 실행 및 로그인 완료
마켓플레이스 추가 완료
instagram-agent 설치 완료
/ig-reel 명령 인식 확인
한국어 릴스 대본 1개 생성
/ig-caption으로 캡션 생성
실제 사실·문구·촬영 가능성 검토
필요하면 voice.md로 말투 설정

10. 공식 출처

2026년 11월 2일 기준 공개된 프로젝트 안내를 참고했습니다. 외부 프로젝트와 Claude Code 업데이트로 명령어나 화면 구성이 바뀔 수 있습니다.


이 도구가 마음에 드셨나요?

YULPlanet 이 자료, 우리 매장에 맞게
적용하고 싶으신가요?

기획부터 편집까지 율플래닛이 함께 만들어 드려요.

자료는 콘텐츠 제작과 업무에 자유롭게 활용하시되, 재배포는 삼가 주세요. 자료 전체 보기 →