face-swap

Route face swaps in images and videos to RunComfy model endpoints.

12|2|Updated May 18, 2026
One-click install
npx skills add https://github.com/runcomfy-com/skills --skill face-swap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: face-swap
Source: https://github.com/runcomfy-com/skills/tree/main/face-swap
Command: npx skills add https://github.com/runcomfy-com/skills --skill face-swap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Face-swap helps you substitute one identity’s face into still images or videos by routing to the right RunComfy model endpoints based on whether the input is a photo or a video and whether you need motion preservation.

Core Features & Use Cases

  • Video character + face swap with motion from audio: Uses Wan 2-2 Animate to drive a new identity from a reference portrait plus an audio track.
  • Motion-preserving identity swap: Uses Kling 2-6 Motion Control Pro to transfer a reference performance video onto a target character image.
  • Still-image face swap with strong fidelity controls: Uses Nano Banana 2 Edit for batch identity-consistent swaps, GPT Image 2 Edit for precise multi-reference compositional swaps, and Flux Kontext Pro for single-image, high-fidelity edits via a declarative instruction.

Quick Start

Use the face-swap skill to swap a face into a video by providing a target identity image and an audio track as inputs to runcomfy.

Frequently Asked Questions about face-swap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I swap a face into a video using an audio track for motion?

To swap a face into a video with audio-driven motion, you provide a target identity image and an audio track. The skill routes these inputs to the Wan 2-2 Animate model to generate a talking character with the substituted identity.

What is the best way to preserve motion when doing an identity swap?

The best way to preserve motion during an identity swap is using the Kling 2-6 Motion Control Pro route. This transfers the performance from a reference video directly onto your target character image.

Can I perform a batch face swap across multiple still images consistently?

Yes, you can perform batch identity-consistent face swaps across still images. The skill uses the Nano Banana 2 Edit model route to ensure strong fidelity and consistent identity substitution throughout the batch.

Does face swapping work for multi-reference compositional edits?

Yes, multi-reference compositional face swaps are supported. The skill routes your structured JSON inputs to the GPT Image 2 Edit model endpoint to execute precise compositional identity substitutions.

How do I do a single-image face swap with high fidelity?

For a single-image face swap with high fidelity, the skill routes your declarative instruction and image to the Flux Kontext Pro model. This endpoint handles precise, high-quality identity substitution in still photos.

Do I need to provide structured JSON inputs for video face swaps?

Yes, you must provide structured JSON inputs matching the endpoint's expected fields. The skill calls the RunComfy CLI with an allowlisted model API route, requiring correctly structured data for still or video processing.