에이전트 스킬은 AI 코딩 에이전트에게 특정 작업의 실행 방법을 알려주는 SKILL.md 파일이다. 2026년 3월 현재, 이 생태계는 코드 생성을 넘어 영상 제작 워크플로까지 확장되었다. 이 가이드에서는 18개 스킬을 AI 영상 파이프라인의 9단계에 매핑하고, 설치 명령어와 호환성을 정리한다.
Claude Code, Codex CLI, Cursor를 사용한다면 스크립팅, 이미지 생성, 영상 편집, 오디오 제작, 퍼블리싱까지 에이전트에게 맡길 수 있다.
관련 글: AI 영상 파이프라인 완전 가이드, 스킬 디렉토리, 에이전트 스킬로 영상 제작 자동화 참조.
빠른 참조 표
| 단계 | 추천 스킬 | 기능 | 설치 |
|---|---|---|---|
| Script | aivp-script | 씬 분석 포함 구조화 스크립트 | npx skills add aivp-script |
| Storyboard | aivp-storyboard | 스크립트에서 비주얼 쇼트 리스트 | npx skills add aivp-storyboard |
| Image | fal-generate | fal.ai 경유 이미지 생성 (FLUX, SD3) | npx skills add fal-generate |
| Video | ai-video-generation | inference.sh 경유 멀티 모델 클립 | npx skills add ai-video-generation |
| Edit | ffmpeg-editing | FFmpeg 트림, 결합, 오버레이, 인코드 | npx skills add ffmpeg-editing |
| Audio | elevenlabs-voice | ElevenLabs 경유 나레이션과 보이스 클론 | npx skills add elevenlabs-voice |
| Metadata | seo-optimizer | SEO 제목, 설명, 스키마 마크업 | npx skills add seo-optimizer |
| Publish | social-content | Shorts/Reels/TikTok용 클립 | npx skills add social-content |
| Review | aivp-review | 자동 품질 체크 | npx skills add aivp-review |
에이전트 스킬이란?
에이전트 스킬은 프론트매터와 일반 텍스트 지침이 포함된 SKILL.md 파일이다. AI 코딩 에이전트가 이를 파싱하고 실행한다. 2026년 초 Anthropic이 Claude Code용으로 도입한 후, Codex CLI, Cursor, Gemini CLI에 채택되었다.
스킬은 셸 스크립트와 다르다. 에이전트가 문맥에 맞게 지침을 해석하고, 누락된 입력에 적응하며, API 호출을 체이닝하고, 정해진 범위 내에서 판단한다. 설치는 npx skills add [skill-name] 한 줄이면 된다.
1. Script
주제를 나레이션, 씬 설명, 타이밍이 포함된 구조화 스크립트로 변환한다.
aivp-script 는 파이프라인 형식의 스크립트를 생성한다.
npx skills add aivp-scriptcreate-viral-content는 훅 중심의 숏폼 스크립트에 특화되어 있다.
npx skills add create-viral-content2. Storyboard
완성된 스크립트를 비주얼 쇼트 리스트로 변환한다. 여기에 투자하면 Video 단계에서의 비싼 재생성을 줄일 수 있다.
aivp-storyboard 는 쇼트별 스토리보드를 생성한다.
npx skills add aivp-storyboard3. Image Generation
영상 키프레임이나 독립 에셋이 되는 비주얼 프레임을 생성한다.
fal-generate는 fal.ai의 추론 API에 연결하여 FLUX.2, SD3 등을 단일 인터페이스로 제공한다.
npx skills add fal-generateaivp-image 는 파이프라인 네이티브 이미지 단계로, 스토리보드 출력을 읽어 씬별로 이미지를 생성한다.
npx skills add aivp-image4. Video Generation
이미지나 텍스트 프롬프트를 영상 클립으로 변환한다. API 크레딧 비용이 가장 많이 드는 단계.
ai-video-generation은 inference.sh의 통합 API를 통해 Seedance, Kling, Minimax 등의 멀티 모델 생성을 제공한다.
npx skills add ai-video-generation5. Editing
클립 조립, 트랜지션, 텍스트 오버레이, 최종 내보내기를 담당한다.
ffmpeg-editing 는 자연어로 FFmpeg 작업을 실행한다.
npx skills add ffmpeg-editingvideo-toolkit 는 멀티트랙 편집, 오디오/영상 동기화, 자막 번인, 플랫폼 내보내기 프리셋을 제공한다.
npx skills add video-toolkit6. Audio
나레이션 생성, 음악 선택, 믹싱을 처리한다.
elevenlabs-voice 는 ElevenLabs API로 보이스 클론, 다국어 출력, SRT 자막 동기화 나레이션을 생성한다.
npx skills add elevenlabs-voice7. Metadata와 SEO
제목, 설명, 태그, 구조화 데이터를 생성하여 발견 가능성을 높인다.
seo-optimizer 는 SEO 최적화된 메타데이터 패키지를 생성한다.
npx skills add seo-optimizer8. Publishing
플랫폼별 포맷 변환, 업로드, 크로스 포스팅을 처리한다.
social-content는 완성된 영상을 플랫폼 최적화 버전으로 변환한다.
npx skills add social-contentyoutube-clipper 는 긴 영상에서 하이라이트 클립을 추출하고 Shorts 최적화 세로형 크롭을 생성한다.
npx skills add youtube-clipper9. Review
퍼블리싱 전 품질 체크를 실행한다.
aivp-review 는 해상도, 프레임레이트, 오디오 레벨, 파일 크기, 메타데이터 완성도를 검증한다.
npx skills add aivp-review설치 및 관리 방법
# 1. 에이전트 설치
npm install -g @anthropic-ai/claude-code
# 2. 스킬 디렉토리 생성
mkdir -p .claude/skills
# 3. 스킬 설치
npx skills add aivp-pipeline
npx skills add ffmpeg-editing
npx skills add elevenlabs-voice
# 4. 스킬 실행
claude
> /aivp-pipeline topic="Product demo video" platform="youtube" style="professional"전체 9단계 오케스트레이션에는 aivp-pipeline 마스터 스킬을 사용한다.
호환성 매트릭스
| 스킬 | Claude Code | Codex CLI | Cursor | Gemini CLI |
|---|---|---|---|---|
| aivp-script | Yes | Yes | Yes | Yes |
| aivp-storyboard | Yes | Yes | Yes | Yes |
| fal-generate | Yes | Yes | Yes | Partial |
| ai-video-generation | Yes | Yes | Partial | Partial |
| ffmpeg-editing | Yes | Yes | Yes | Yes |
| video-toolkit | Yes | Yes | Yes | Partial |
| elevenlabs-voice | Yes | Yes | Yes | Yes |
| seo-optimizer | Yes | Yes | Yes | Yes |
| social-content | Yes | Yes | Partial | Partial |
| youtube-clipper | Yes | Yes | Yes | Partial |
| aivp-review | Yes | Yes | Yes | Yes |
| prompt-architect | Yes | Yes | Yes | Yes |
"Partial"은 스킬이 동작하지만 해당 플랫폼에서 전체 도구 접근이 제한될 수 있음을 의미한다.
FAQ
영상 제작용 AI 에이전트 스킬이란?
특정 영상 제작 작업에 대한 기계 판독 가능 지침이 담긴 SKILL.md 파일이다. AI 에이전트가 이를 읽고 API 호출, 파일 작성, 명령 실행, 단계 간 출력 체이닝을 자율적으로 수행한다.
에이전트 스킬은 어떻게 설치하나?
npx skills add [skill-name]을 실행한다. SKILL.md가 .claude/skills/에 다운로드된다. GitHub이나 skills.sh에서도 설치 가능하다.
Cursor나 Codex에서도 동작하나?
SKILL.md 형식은 에이전트에 구애받지 않는다. Claude Code, Codex CLI, Cursor가 네이티브 지원한다. Gemini CLI는 부분 지원.
여러 스킬을 파이프라인으로 체이닝할 수 있나?
가능하다. aivp-pipeline이 전체 9단계를 체이닝하며 각 출력이 다음 단계로 전달된다.
에이전트 스킬은 무료인가?
스킬 자체는 무료 오픈소스다. 스킬이 호출하는 외부 API(ElevenLabs, fal.ai, inference.sh)에는 각각의 요금 체계가 있다.
커스텀 스킬은 어떻게 만드나?
YAML 프론트매터와 Markdown 본문으로 SKILL.md를 작성하여 .claude/skills/your-skill-name/SKILL.md에 배치한다. 에이전트 스킬 자동화 가이드 참조.
