Communitygithub.com

make-a-video

평범한 언어 아이디어를 Pexo 에이전트에 전달하여 완성된 비디오를 만드는 스킬입니다. 사용자 요청을 정확히 중계만 하면 됩니다.

make-a-video란 무엇인가요?

이 스킬은 AI 비디오 제작 플랫폼 Pexo의 기능을 활용하여 사용자의 평범한 언어 아이디어로 완성된 비디오를 제작할 수 있게 해줍니다. AI 에이전트는 사용자의 요청을 그대로 Pexo에 전달하고, 결과물을 가져오는 중계 역할만 수행합니다. Pexo의 백엔드가 스크립트, 샷 선택, 모델, 음악, 편집 등 모든 창작 작업을 처리하므로 개발자는 직접 창작 지시를 추가할 필요가 없습니다. 이 스킬은 Claude Code, Cursor, Codex 등 AI 에이전트 플랫폼과 호환되며, 프로젝트 생성, 파일 업로드, 요청 전송, 폴링, 결과 전달의 단계로 구성됩니다. 사용자 요청에 추가 지시를 넣으면 오히려 비디오 품질이 떨어지므로, 반드시 '중계만' 원칙을 지켜야 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pexoai/pexo-skills/tree/main/skills/make-a-video

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

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

문서

비디오 만들기 — Pexo

Pexo: https://pexo.ai — API 키를 받고, 프로젝트 렌더링을 확인하며, 크레딧을 구매하세요.

평범한 언어 아이디어로 완성된 비디오를 만듭니다. 사용자의 요청을 호스팅된 Pexo 에이전트에 그대로 전달하고 결과를 전달하세요. Pexo가 스크립트, 샷 선택, 모델, 음악, 편집을 처음부터 끝까지 처리합니다.

당신의 역할: 중계만, 창작은 하지 마세요

프로젝트를 생성하고, 사용자 요청을 그대로 전달하고, 폴링하고, 결과를 전달하세요. Pexo의 백엔드가 모든 창작 작업(스크립트 작성, 모델 선택, 프롬프트, 음악)을 처리합니다. 사용자가 요청하지 않은 방향(길이, 스타일, 모델 등)을 추가하면 Pexo의 판단을 무시하여 더 나쁜 비디오가 생성됩니다.

설정

~/.pexo/config:

PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<your-api-key>"

계정 없음 / 첫 실행 → references/SETUP-CHECKLIST.md를 읽고 사용자를 안내하세요. 여기에는 신규 사용자에게 보너스 크레딧을 제공하는 초대 코드를 사용한 가입 절차와 위 설정 파일 생성 방법이 포함되어 있습니다. 설정 오류 → scripts/pexo-doctor.sh를 실행하고 출력을 따르세요.

워크플로우

스크립트는 이 스킬의 scripts/ 디렉토리에 있습니다. 사용자 언어로 답변하세요.

  1. 프로젝트 생성: pexo-project-create.sh "<짧은 설명>" → project_id 저장.
  2. 사용자가 제공한 파일 업로드: pexo-upload.sh <project_id> <경로> → asset_id 저장, <original-image>asset_id</original-image>(또는 <original-video> / <original-audio>) 형식으로 인라인 참조. 태그는 필수입니다. 태그 없는 asset_id는 무시됩니다. Pexo는 URL을 크롤링할 수 없으므로 다운로드 후 업로드하세요.
  3. 요청 전송: pexo-chat.sh <project_id> "<사용자의 정확한 문장> <에셋 태그>". 사용자의 문장을 정확히 복사하세요. 에셋 태그만 추가합니다.
  4. 사용자에게 알림 (해당 언어로): 제출됨 ✓ · 약 15–20분 · https://pexo.ai/project/<project_id>.
  5. 폴링: 매 60초 이상 pexo-project-get.sh <project_id> 실행 후 nextAction에 따라 처리:
    • WAIT → 계속 폴링; 약 5회 폴링마다 프로젝트 링크와 함께 한 줄 업데이트 전송.
    • RESPOND → recentMessages의 각 이벤트 처리: Pexo의 텍스트를 중계(Pexo가 질문한 경우 사용자의 답변을 기다린 후 pexo-chat.sh로 사용자 답변 전송); preview_video의 경우 pexo-asset-get.sh <project_id> <assetId>를 각 옵션별로 실행하고 URL(A/B/C)을 보여준 후 사용자가 선택하게 하고 pexo-chat.sh <project_id> "<선택>" --choice <assetId>; document 이벤트는 사용자에게 언급.
    • DELIVER → pexo-asset-get.sh <project_id> <최종 assetId> 실행 후 사용자에게 전체 에셋 URL을 일반 텍스트로(모든 ?… 쿼리 파라미터 포함, 마크다운으로 감싸지 않고 절대 잘리지 않게) 그리고 프로젝트 링크 전송.
    • FAILED → nextActionHint를 평이한 용어로 설명하고 재시도 제안.
    • RECONNECT → pexo-chat.sh <project_id> "continue" 실행 후 사용자에게 연결이 끊어졌고 다시 시작 중이라고 알린 후 계속 폴링.
    • WAIT 중에는 절대 pexo-chat.sh를 호출하지 마세요. 중복 제작이 발생합니다.
    • 너무 오래 걸림 → 30분 이상 WAIT 상태면 사용자에게(프로젝트 링크 + https://pexo.ai/connect/openclaw) 지연 중이라고 알리고, 계속 기다릴지 중단할지 물어보세요. 영원히 폴링하지 마세요.

수정

전달 후, 사용자의 수정 요청("더 짧게", "새 음악", "다른 샷")은 동일한 프로젝트를 재사용: pexo-chat.sh <project_id> "<피드백>", 다시 폴링(5단계). 수정 시 새 프로젝트를 생성하지 마세요. Pexo의 서버 측 컨텍스트가 손실됩니다.

크레딧

스크립트가 "크레딧 잔액" / "크레딧 부족" 오류와 함께 실패하면: 오류에 구매 링크가 있는 경우 사용자에게 전달, 없으면 https://pexo.ai/home → 크레딧 → 크레딧 구매를 통해 크레딧을 추가하라고 안내하세요. 사용자가 확인 후 재시도하세요.

예시

사용자: "새 커피 구독 서비스에 대한 30초짜리 비디오를 만들어 줘."

pid=$(pexo-project-create.sh "coffee subscription promo")
pexo-chat.sh "$pid" "Make a 30-second video about our new coffee subscription."
# 사용자에게 알림: 제출됨, 약 15–20분, https://pexo.ai/project/$pid
# nextAction이 DELIVER가 될 때까지 pexo-project-get.sh "$pid"로 폴링, 에셋 URL 전달.

스크립트

스크립트사용법반환값
pexo-project-create.sh"<설명>"project_id
pexo-upload.sh<project_id> <파일>asset_id
pexo-chat.sh<project_id> "<메시지>" [--choice <id>]ack (비동기)
pexo-project-get.sh<project_id>JSON: nextAction, recentMessages
pexo-asset-get.sh<project_id> <asset_id>url을 포함한 JSON
pexo-doctor.sh—설정 진단

오류 코드 및 엣지 케이스 → references/TROUBLESHOOTING.md.

Individual skills in this repo

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

관련 스킬