Communitygithub.com

PrunaAI/pruna-skills

비디오의 색상, 스타일, 객체, 환경, 조명, 텍스트를 텍스트 지시로 편집할 때 사용합니다. 참조 이미지를 활용한 제품 및 액세서리 편집도 지원합니다. 새 비디오 생성이나 ffmpeg 조립에는 사용하지 않습니다.

pruna-skills란 무엇인가요?

이 스킬은 기존 비디오에 대해 텍스트 명령어 기반의 편집을 수행하는 Pruna AI의 p-video-edit 모델을 사용하는 방법을 안내합니다. 사용자는 소스 비디오의 색상, 스타일, 객체 추가/제거, 환경 변경, 조명 조정, 텍스트 수정 등을 자연어로 지시할 수 있으며, 최대 4개의 참조 이미지를 제공하여 원하는 제품이나 액세서리를 가이드할 수도 있습니다. 한 번의 실행으로 하나의 주요 변경만 수행하도록 설계되어 있으며, 변경되지 않아야 할 요소(카메라 움직임, 조명, 주제)를 명시하는 'keep clause'를 함께 작성하여 충실도를 높입니다. Pruna AI API를 직접 호출하며, 동기/비동기 HTTP 요청을 모두 지원하고, 초안 모드를 통해 빠르고 저렴한 미리보기를 제공합니다. Cursor, Claude Code 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 설치 시 generation-diversity, video-prompting, pruna-api와 같은 보조 스킬을 함께 로드하는 것이 좋습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/PrunaAI/pruna-skills/tree/HEAD/skills/video/p-video-edit

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

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

문서

전제 조건

생성 전에 다음 스킬을 설치하고 로드하세요 (@pruna를 통해 이미 컨텍스트에 있다면 건너뛰세요):

스킬설명설치 명령어
generation-diversity모든 생성 프롬프트 작성 시 사용 — 유료 API 호출 전 의식 시드, 명시적 구조, 시나리오 축, 품질 게이트를 포함합니다.npx skills add PrunaAI/pruna-skills@generation-diversity -y
video-prompting모든 생성 모델의 비디오 또는 모션 프롬프트 작성 시 사용 — 드라마투르기, 카메라, 물리적으로 안전한 모션, 프레임 앵커, 클립 체이닝을 포함합니다.npx skills add PrunaAI/pruna-skills@video-prompting -y
pruna-apiPruna 또는 Replicate HTTP 호출 전에 사용 — 자격 증명, 업로드/폴링/다운로드, 병렬 배치, 에이전트 안전을 포함합니다.npx skills add PrunaAI/pruna-skills@pruna-api -y

또는 전체 스위트를 한 번에 설치: npx skills add PrunaAI/pruna-skills@pruna -y

각 스킬의 생성 전 / 제작 섹션을 따르세요. 여기서 가이드 내용을 반복하지 마십시오.

에이전트 습관

첫 번째 답변에서 `p-video-edit`을 백틱으로 언급하고, PRUNA_API_KEY를 확인한 후 (또는 pruna-api에서 가입 링크와 함께 중단), 소스 비디오(최대 15초)와 편집 요청을 물어보세요. 인테이크 시작 → generation-diversity 명확화 인테이크를 첫 POST 전에 수행합니다. 동적 + 충실한 프롬프트 제작으로 편집문을 작성하세요. 스킬 예제를 그대로 붙여넣지 마십시오. 사용하지 말아야 할 때가 더 적합한 경우 리디렉션하세요.

프롬프트 제작 (동적 + 충실)

prompt는 정밀하고 요청에 고정되어야 합니다. 실행당 하나의 주요 변경만 수행합니다. 원하는 최종 상태를 설명한 다음, 변경되지 않아야 할 것을 명시하세요. 사용자가 요청한 것만 변경하고 카메라, 모션, 오디오, 언급되지 않은 요소는 동일하게 유지하세요.

해야 할 것하지 말아야 할 것
공식: 다음만 변경: [X]. 유지: [기하학 / 모션 / 카메라 / 조명 / 언급되지 않은 피사체].모호한 더 좋게 만들어 줘 / 분위기만 바꾸는 새 장면을 만들어내는 재작성
사용자가 지정한 모든 필수 유지 항목(피사체, 카메라 경로, 조명, 소품)을 명시유지 절을 생략하고 모델이 알아서 유지해 주길 기대
제작 전에 의식 시드; 요청이 허용할 때 유지 절에 새로운 표현 사용이 스킬의 예제(일몰 하늘)를 사용자가 다른 편집을 설명했을 때 그대로 복사
참조 이미지 사용 시: 첫 번째 참조 이미지의 액세서리를 추가하세요출처 슬롯 없이 모호한 참조 이미지 사용
문구가 고정되지 않았을 때 POST 전에 prompt를 보여줌카메라, 출연진, 또는 요청되지 않은 영역을 변경하는 무음 편집

충실도 확인 (결제 전): 프롬프트가 사용자의 변경 요청 그리고 명시된 모든 유지 항목을 여전히 만족해야 합니다. 사용자가 하나의 속성이나 환경 편집을 요청했을 때 추가 요소를 '양념'으로 넣지 마십시오.

약한 작업 (피하거나 경고): 완전히 새로운 장면/줄거리; 독립적인 모션을 가진 객체 추가 (특히 손에 쥐는 새로운 형태); 카메라 각도, 카메라 움직임, 줌 변경.

스킬 경계

p-video-editp-video-replace
사용자 질문이 클립의 색상/환경/객체/텍스트/조명을 변경해 줘?이 비디오에서 이 사람을 교체해 줘?
목표소스 클립에 대한 명령어 기반 편집기존 푸티지 안으로 신원 교체
참조 이미지선택 사항인 images — 0 ~ 4개필수 images — 1 ~ 4개
프롬프트 필드promptinstruction_prompt

필수 참조 스틸 사진으로 캐릭터를 교체하는 작업은 p-video-replace를 사용하세요. 이 스킬은 프롬프트 기반 속성, 환경, 객체, 텍스트 또는 조명 편집에 사용합니다.

사용하지 말아야 할 때

대신 다른 스킬을 사용하세요:

스킬설명설치 명령어
p-video-2-pro텍스트나 시작/종료 프레임으로 영화 같은 클립을 만들고 싶을 때 — 제품 광고, 다큐멘터리 샷, 생성된 오디오가 있는 대화. 1080p, 가져온 오디오 트랙 또는 토크쇼 진행자 전용에는 적합하지 않습니다.npx skills add PrunaAI/pruna-skills@p-video-2-pro -y
p-video-2텍스트, 이미지 또는 가져온 오디오로 세련된 짧은 클립을 만들고 싶을 때 — 1080p B-roll, 시작/종료 프레임 애니메이션, 혼합 트랙이 포함된 모션 샷. 영화 같은 생성 오디오 클립 또는 토크쇼 진행자 전용에는 적합하지 않습니다.npx skills add PrunaAI/pruna-skills@p-video-2 -y
p-video텍스트나 이미지로 간단한 짧은 클립을 만들고 싶을 때 — 빠른 B-roll, 초안, 시작/종료 프레임 애니메이션. 요구 사항에 영화 같은 생성, 최고 품질, 정확한 립싱크 또는 1080p에서 가져온 오디오가 필요한 경우에는 적합하지 않습니다.npx skills add PrunaAI/pruna-skills@p-video -y
p-video-replace기존 푸티지 내에서 사람, 의상 또는 제품을 교체하면서 카메라 움직임과 오디오를 유지하려는 경우 사용합니다.npx skills add PrunaAI/pruna-skills@p-video-replace -y
p-video-animate사진을 다른 비디오처럼 움직이게 하고 싶을 때 — 모션 전송, 댄스 리믹스, 템플릿 클립의 퍼포먼스 변형.npx skills add PrunaAI/pruna-skills@p-video-animate -y
video-editingffmpeg로 이미 렌더링된 클립을 조립하거나 다듬을 때 — 연결, 크로스페이드, 자막 및 번역 자막 삽입, 텍스트/로고 오버레이, 전후 비교 슬라이더, 배경 음악, 플랫폼 내보내기 — 또는 Hyperframes로 다중 레이어 HTML 조합 비디오를 구성할 때 사용합니다. AI 비디오 생성, 프롬프트 제작 또는 모델 기반 비디오 편집에는 사용하지 않습니다.npx skills add PrunaAI/pruna-skills@video-editing -y

HTTP (curl)

소스 비디오 업로드

curl -X POST "https://api.pruna.ai/v1/files" \
  -H "apikey: ${PRUNA_API_KEY}" \
  -F "content=@/path/to/source-video.mp4"

응답의 urls.get을 input.video에 사용하세요. 소스 비디오 최대 길이: 15초.

선택적 참조 이미지

curl -X POST "https://api.pruna.ai/v1/files" \
  -H "apikey: ${PRUNA_API_KEY}" \
  -F "content=@/path/to/reference-image.png"

각 응답의 urls.get을 input.images에 사용하세요 (최대 4개; jpg, jpeg, png, webp).

생성 (비동기 — 권장)

curl -X POST 'https://api.pruna.ai/v1/predictions' \
  -H 'Content-Type: application/json' \
  -H "apikey: ${PRUNA_API_KEY}" \
  -H 'Model: p-video-edit' \
  -d '{
    "input": {
      "video": "https://api.pruna.ai/v1/files/source-video-abc123",
      "prompt": "하늘만 일몰로 변경하세요. 피사체, 카메라 경로, 전경 조명은 유지하세요."
    }
  }'

폴링 및 다운로드: pruna-api를 따르세요. 출력 길이는 소스 비디오를 따릅니다. 과금은 반환된 초당 (표준 $0.045, 초안 $0.025)입니다. 속도 제한: 분당 50개 요청.

프롬프트를 작성하기 전에 generation-diversity의 무작위 시드 의식을 완료하세요. 의식 문자열을 API seed로 전달하지 마십시오. 선택적 seed는 사용자가 재현성을 요청할 때만 사용하세요.

생성 (동기 — 빠른 테스트 전용)

curl -X POST 'https://api.pruna.ai/v1/predictions' \
  -H 'Content-Type: application/json' \
  -H "apikey: ${PRUNA_API_KEY}" \
  -H 'Model: p-video-edit' \
  -H 'Try-Sync: true' \
  -d '{
    "input": {
      "video": "https://api.pruna.ai/v1/files/source-video-abc123",
      "prompt": "하늘만 일몰로 변경하세요. 피사체, 카메라 경로, 전경 조명은 유지하세요.",
      "draft": true
    }
  }'

생성 전

  1. 전제 조건 가이드를 읽는 순서를 완료하세요 (generation-diversity → video-prompting).
  2. 의식 시드 → 동적 + 충실한 prompt 작성 (위 섹션) → video (≤15초), prompt, 선택적 images (0~4개), draft, save_audio, 편집 의도 (속성 / 제거 / 추가 / 환경 / 재조명 / 텍스트 / 참조 가이드)를 확인하세요.
  3. Pruna 참고 사항: 실행당 하나의 주요 변경만 하세요. 신원 또는 제품 일치는 선택적 images에서 비롯됩니다. 편집 지시는 prompt에 있습니다. 모호한 대상과 완전히 새로운 장면은 품질을 떨어뜨립니다. task 필드를 보내지 마십시오. 공개 API에 없습니다.

필수 입력

  • video (문자열 URL): 편집할 소스 비디오. 최대 길이: 15초
  • prompt (문자열): 편집을 설명하는 텍스트 명령어

공통 선택적 필드

  • images (최대 4개 문자열 URL의 배열): 참조 가이드 편집을 위한 참조 이미지 (jpg, jpeg, png, webp)
  • prompt_upsampling (부울, 기본값 true)
  • draft (부울, 기본값 false): 더 빠르고 저품질인 미리보기; 출력 초당 $0.025로 과금
  • save_audio (부울, 기본값 true)
  • seed (정수): 재현 가능한 재실행을 위해서만 설정

일반적인 다음 단계

이 스킬 후 자주 이어지는 작업:

스킬설명설치 명령어
p-video-replace기존 푸티지 내에서 사람, 의상 또는 제품을 교체하면서 카메라 움직임과 오디오를 유지하려는 경우 사용합니다.npx skills add PrunaAI/pruna-skills@p-video-replace -y
p-image-edit기존 사진을 편집하고 싶을 때 — 의상이나 배경 변경, 참조 이미지로 구성, 또는 프롬프트 기반 편집 적용.npx skills add PrunaAI/pruna-skills@p-image-edit -y
video-editingffmpeg로 이미 렌더링된 클립을 조립하거나 다듬을 때 — 연결, 크로스페이드, 자막 및 번역 자막 삽입, 텍스트/로고 오버레이, 전후 비교 슬라이더, 배경 음악, 플랫폼 내보내기 — 또는 Hyperframes로 다중 레이어 HTML 조합 비디오를 구성할 때 사용합니다. AI 비디오 생성, 프롬프트 제작 또는 모델 기반 비디오 편집에는 사용하지 않습니다.npx skills add PrunaAI/pruna-skills@video-editing -y

Individual skills in this repo

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

PrunaAI/pruna-skills

Use when someone needs spoken narration or voiceover — explainer tracks, documentary lines, or voice to pair with generated video.

PrunaAI/pruna-skills

Use when someone wants an original AI song with vocals — sung lyrics, a style prompt track, or source audio for a music video.

PrunaAI/pruna-skills

Use when someone needs word-level timestamps from audio — lyric alignment, cut-safe line boundaries, or caption source timing before burn-in with video-editing.

PrunaAI/pruna-skills

Use before any Pruna or Replicate HTTP call — credentials, upload/poll/download, parallel batches, and agent safety.

PrunaAI/pruna-skills

Use when assembling or polishing already-rendered clips with ffmpeg — concat, crossfades, burned captions and subtitles, text/logo overlays, before/after sliders, background music beds, platform export — or when composing a multi-layer HTML combination video with Hyperframes. Not for AI video generation, prompt craft, or model-based video edits.

PrunaAI/pruna-skills

Use when crafting video or motion prompts for any generative model — dramaturgy, camera, physics-safe motion, frame anchors, and clip chaining.

PrunaAI/pruna-skills

Use when someone wants to edit an existing photo — change outfits or backgrounds, compose from reference images, or apply prompt-driven edits.

PrunaAI/pruna-skills

Use when someone explicitly wants the fastest, cheapest photo generation — mood boards, bulk panels, or quick iterations — not when controlled photoreal or in-image text is needed.

PrunaAI/pruna-skills

Use when someone wants virtual try-on — dress a person in clothes from reference photos for fashion or ecommerce.

PrunaAI/pruna-skills

Use when installing the full Pruna generative media suite — all guides, tools, and workflows in one package.

PrunaAI/pruna-skills

Use when someone wants a cinematic clip from text or start/end frames — product ads, documentary shots, or dialogue with generated audio. Not for 1080p, imported audio tracks, or talking-head-only hosts.

PrunaAI/pruna-skills

Use when someone wants a polished short clip from text, images, or imported audio — 1080p B-roll, start/end frame animation, or a motion shot with a mixed track. Not for cinematic generated-audio clips or talking-head-only hosts.

PrunaAI/pruna-skills

Use when someone wants a simple short clip from text or images — quick B-roll, drafts, or start/end frame animation. Not when the brief needs cinematic generation, highest quality, tight lip-sync, or imported audio at 1080p.

관련 스킬