face-swap

Swap faces and characters in images and videos via the RunComfy CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @runcomfy/cli.

What problem does it solve? Choosing the right model for a face or character swap is confusing — stills, videos, batch edits, and motion transfer each need a different model and input schema. This Skill routes your intent to the correct RunComfy model endpoint and invokes it through the runcomfy CLI with the right JSON payload. ## Core Features & Use Cases - Intent-based model routing: Picks among Wan 2-2 Animate (video character swap with audio), Kling 2-6 Motion Control Pro (motion transfer), GPT Image 2 Edit (multi-reference still swap), Nano Banana 2 Edit (batch identity-preserving swap), and Flux Kontext Pro (single-image prose-described face edit). - Ready-to-run CLI commands: Each route includes the exact runcomfy run <model_id> --input '{...}' invocation with schema notes and prompting tips. - Consent and safety guidance: Explicit dual-use disclosure requirements and refusal criteria for non-consensual or harmful synthetic media. - Use Case: A marketer wants to cast a brand spokesperson into existing footage — the Skill selects Wan 2-2 Animate, builds the input JSON with the spokesperson's portrait and the original audio track, and downloads the rendered video. ## Quick Start Ask the agent to swap the face from one image into a target photo or video using RunComfy, and it will pick the right model route and run the CLI command for you.

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 in a video with AI?▼

Use the Wan 2-2 Animate endpoint via `runcomfy run community/wan-2-2-animate/api` with a reference image of the new identity and an audio track. The model produces a video where the new character drives the performance.

Which model should I use for face swap on still images?▼

Use GPT Image 2 Edit for precise multi-reference swaps on a single hero still, Nano Banana 2 Edit for swapping one identity consistently across up to 20 frames, or Flux Kontext Pro when you have no reference face image and describe the new face in prose.

What is the difference between Wan 2-2 Animate and Kling Motion Control?▼

Wan 2-2 Animate is audio-driven character animation from a single reference image. Kling 2-6 Motion Control Pro transfers the exact motion and blocking of a reference performance video onto a target character image, with face swap as a byproduct.

Can I swap faces in batch across multiple images?▼

Yes. Nano Banana 2 Edit accepts 1-20 input images per call. Place the identity reference as the first image URL, list the scene images after it, and lock aspect_ratio and resolution for consistent batch output.

Is it allowed to swap a real person's face without consent?▼

No. The Skill requires rights to both the target face and the source asset, and instructs agents to refuse requests targeting real people without consent or aiming at defamatory, sexually explicit, or otherwise harmful synthetic media.

Why did my face swap produce the wrong identity or motion?▼

Reference image, audio, and video URLs are untrusted inputs and a known injection target. Ingest only URLs the user explicitly provided, and suspect the reference asset when output diverges from the prompt.