Social AI Team

소규모 및 중견 기업을 위한 완벽한 소셜 미디어 팀 역할을 하는 Claude Code 스킬 세트입니다. 각 스킬은 전문성을 가지고 있습니다. 이들이 함께 작동하여 브랜드 설정부터 플랫폼별 콘텐츠 생성, 예약, 월간 성과 검토에 이르는 전체 워크플로우를 실행합니다.

Claude Code 내부에서 실행되도록 구축되었습니다.

막 시작하시나요? SETUP.md를 읽어보세요. Claude Code, 설치, MCP 설정 및 첫 번째 클라이언트를 다루는 전체 초보자 가이드입니다.

스킬 작동 방식

/social-media-manager  ← 여기서 시작 (모든 것을 오케스트레이션)
         │
         │  LAYER 1 — FOUNDATION
...

스킬 간 상호 참조:

• /brand-onboarding → brand-style.md 작성 → 모든 콘텐츠 스킬이 읽음
• /content-calendar → content-calendar.md 작성 → 모든 Layer 2 콘텐츠 스킬이 읽음
• /caption-writer → Visual Direction 필드 작성 → /social-creative-designer가 읽음
• /linkedin-writer, /threads-writer, /x-writer → BLOTATO FLAG 필드 작성 → /publisher가 읽음
• /social-performance-review → best-performers.md 업데이트 → 다음 달 모든 콘텐츠 스킬이 읽음

각 스킬의 역할

/social-media-manager — 오케스트레이터 (Orchestrator)

코디네이터입니다. 클라이언트 워크플로우의 현재 상태를 읽고 적절한 시작 지점(신규 클라이언트 설정, 월간 제작, 플랫폼별 콘텐츠, 월말 검토 또는 특정 작업)으로 라우팅합니다. 모든 핸드오프 지점에 일시 중지 및 승인 게이트가 있어 후속 단계에서 발생하는 실수를 방지합니다.

/brand-onboarding — 브랜드 전략가 (Brand Strategist)

다른 어떤 것보다 먼저 클라이언트당 한 번 실행됩니다. Playwright를 사용하여 클라이언트 웹사이트와 Instagram의 증거를 캡처하고, 미리 채워진 클라이언트 온보딩 문서를 생성한 다음, 모든 것을 context/brand-style.md로 종합하여 모든 창작 및 콘텐츠 작업의 단일 진실 공급원(single source of truth)을 만듭니다.

/content-calendar — 소셜 미디어 전략가 (Social Media Strategist)

게시물 아이디어가 담긴 구조화된 한 달 계획을 수립합니다. 콘텐츠 기둥 비율(content pillar ratios)과 형식 혼합(format mix)을 구축하기 전에 정의합니다. 각 게시물 항목에는 주제, 관점(angle), 형식, 목표, 시각적 방향이 포함됩니다. 모든 콘텐츠 스킬이 읽을 수 있도록 context/content-calendar.md에 저장합니다.

/caption-writer — 선임 카피라이터 (Senior Copywriter)

캘린더에서 바로 게시할 준비가 된 캡션을 작성합니다. 여섯 가지 스토리텔링 프레임워크를 사용하며, Instagram / LinkedIn / Facebook / TikTok / X 등 플랫폼별 형식에 맞춰 작성됩니다. 모든 캡션에는 /social-creative-designer에게 전달하는 메모로 '시각적 방향(Visual Direction)' 필드가 포함됩니다.

/social-creative-designer — 크리에이티브 디자이너 (Creative Designer)

Nano Banana 이미지 생성 MCP를 사용하여 브랜드에 맞는 소셜 비주얼을 생성합니다. 네 가지 모드를 지원합니다:

• Generate — 개념(라이프스타일 / 분위기 콘텐츠)으로부터 AI 이미지 생성
• Composite — 고객의 실제 제품 사진을 AI가 생성한 장면에 고정(anchors)
• Brand — 실제 고객 사진에 텍스트 오버레이 처리를 적용
• Stop-Motion — 루핑 MP4 릴스로 내보내는 6프레임 액션 시퀀스

/linkedin-writer — LinkedIn 콘텐츠 전문가 (LinkedIn Content Specialist)

LinkedIn 네이티브 게시물(adapted captions가 아닌)을 작성합니다. 첫인칭, 전문적이면서도 인간적인 어조를 사용하며, LinkedIn 형식에 맞춰 구조화됩니다: 후크 라인 → 짧은 단락 → 통찰력(insight) → CTA(Call to Action) → 해시태그 3~5개. Blotato 인포그래픽(통계, 프레임워크, 번호 목록)이 도움이 될 게시물을 표시합니다.

/threads-writer — Threads 콘텐츠 전문가 (Threads Content Specialist)

Threads 게시물을 작성합니다: 짧고, 직접적이며, 의견 중심적이고, 대화를 유도하도록 제작됩니다. 모든 게시물에 글자 수를 포함하여 500자 제한을 엄격히 준수합니다. 단독 게시물과 연결된 스레드를 모두 지원합니다. Threads에서 성과가 좋은 팁(outperform tips)을 활용하여 — 이 스킬은 플랫폼이 실제로 작동하는 방식에 맞춰 작성됩니다.

/x-writer — X/트위터 콘텐츠 전문가

X 네이티브 게시물과 스레드를 작성합니다. 280자 제한을 엄격하게 지키며, 모든 게시물에 글자 수를 표시합니다. 컨텍스트 없이도 작동하며, 워밍업이나 서문이 필요 없습니다. X 스레드 형식(1/, 2/...). X API를 통한 선택적 트렌드 조사 기능이 있습니다.

/publisher — 소셜 미디어 게시 담당자

모든 콘텐츠 기술에서 승인된 콘텐츠를 받아 Blotato MCP를 통해 예약합니다. 먼저 Blotato 연결 상태를 확인하며, 연결되지 않은 경우 명확한 설정 메시지를 표시합니다. 플랫폼 전문가가 플래그 지정한 게시물에 대해 인포그래픽 비주얼(통계 카드, 프레임워크 다이어그램, 3단계 프로세스 그래픽, 인용구 그래픽)을 생성합니다. 무언가를 제출하기 전에 전체 예약 확인 절차를 거칩니다. Blotato는 선택 사항이며, 다른 모든 기술은 이것 없이도 작동합니다.

/social-performance-review — 소셜 미디어 분석가

월별 성과 검토입니다. CSV 내보내기, 스크린샷 또는 수동 데이터 입력을 받으며, 고객이 제공할 수 있는 어떤 형식에도 적응합니다. 최고 및 최저 성과를 낸 항목, 콘텐츠 기둥(content pillar) 및 형식 패턴을 식별하고 다음 달에 대한 순위가 매겨진 권장 사항을 생성합니다. 콘텐츠 품질 피드백을 위해 best-performers.md 파일을 업데이트합니다.

폴더 구조 (클라이언트별)

이 기술들을 클라이언트를 위해 실행하면, 이 구조를 자동으로 생성하고 읽습니다:

your-client-folder/
├── context/
│   ├── brand-style.md          ← /brand-onboarding에 의해 생성됨
...

설치

새로운 사용자이신가요? 전체 초보자 가이드(Claude Code, MCPs 및 첫 번째 클라이언트 폴더)는 SETUP.md를 참조하세요.

1. 파일 가져오기

옵션 A — git으로 복제:

git clone https://github.com/stevenflanagan1/social-ai-team.git
cd social-ai-team

옵션 B — ZIP 다운로드: 이 저장소 상단의 녹색 Code 버튼을 클릭하고, Download ZIP을 선택한 후 압축을 풀고, 터미널에서 social-ai-team 폴더를 엽니다.

2. 설치 프로그램 실행

Mac / Linux:

bash install.sh

Windows: install.bat을 더블클릭하거나 (또는 명령줄에서 실행합니다).

이것은 10가지 모든 스킬을 ~/.claude/skills/에 복사하여 Claude Code가 찾을 수 있게 합니다.

MCP 요구 사항 (MCP Requirements)

일부 스킬은 향상된 기능을 위해 MCP 도구를 사용합니다. 스킬들은 이 도구 없이도 **기본 모드(baseline mode)**로 작동하지만, 이를 통해 추가적인 기능이 활성화됩니다:

스톱모션 릴스 (Stop-Motion Reels) (선택 사항)

The /social-creative-designer의 스톱모션 모드는 파이썬을 통해 프레임을 MP4로 내보냅니다. 다음이 필요합니다:

pip install imageio[ffmpeg]

사용 방법 (How to Use)

신규 클라이언트 (New client)

/social-media-manager

오케스트레이터(orchestrator)는 브랜드 파일이 존재하지 않음을 감지하고, 먼저 /brand-onboarding을 통해 안내합니다.

특정 스킬 직접 실행하기 (Running a specific skill directly)

/brand-onboarding
/content-calendar
/caption-writer
...

콘텐츠 게시하기 (Blotato) (Publishing content)

플랫폼 전문가를 사용하여 LinkedIn, Threads 또는 X 콘텐츠 작성을 마친 후:

/publisher

게시자(publisher)는 Blotato 연결을 확인하고, 플래그가 지정된 인포그래픽 기회들을 검토하며, 일정을 확정하고, 제출합니다. 이 기능을 사용하려면 먼저 Blotato를 설정해야 합니다 — 위 MCP 요구 사항 섹션을 참조하세요.

월별 워크플로우 (기존 클라이언트) (Monthly workflow)

/social-media-manager

오케스트레이터는 context/workflow-status.md 파일을 읽고, 사용자가 중단했던 지점부터 정확하게 이어서 진행합니다.

클라이언트별 권장 설정 (Recommended Setup per Client)

1. 클라이언트를 위한 전용 폴더를 만듭니다.
2. 스킬을 실행하기 전에 해당 폴더로 cd 이동합니다 — 컨텍스트 파일은 작업 디렉토리에 한정됩니다.
3. /social-media-manager를 실행하여 시작합니다.

mkdir my-client && cd my-client
# 이 폴더에서 Claude Code 열기
# 그리고 /social-media-manager 실행

참고 파일 (Reference Files)

세 가지 참고 문서가 관련 스킬과 함께 번들로 제공됩니다:

라이선스

AI Impact가 생성했습니다. 사용하고, 적응시키고, 구축하세요. 맞춤 빌드를 원하시나요? https://theaiimpact.co/