Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

faceswap — Claude Code skill: what it does, how to install

Video face swap skill powered by the HeyGen API. It replaces a person's face in a video using a single source portrait.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add calesthio/OpenMontage --skill faceswap -a claude-code
Open on GitHub

What faceswap does

The skill configures workflow calls to HeyGen via the /v1/workflows/executions endpoint. It submits a FaceswapNode task containing a source face picture and a target video file. The API answers with an execution ID for tracking.

Remote GPU processing takes between 1 and 3 minutes. The assistant polls the execution status every 10 seconds until the job completes. Without setting HEYGEN_API_KEY in your environment, every request fails immediately.

What it helps with

  • swap a face in an existing video with a new portrait
  • automate HeyGen face swap workflow executions
  • generate personalized marketing videos from a single photo

Example prompts for the agent

  • Swap the face in target-video.mp4 with the person from face-photo.jpg using HeyGen
  • Run a FaceswapNode workflow with my source portrait and wait for the result
  • Submit a face swap execution to the HeyGen API and poll until completed

How to install faceswap

1Skills CLI (Vercel)

npx skills add calesthio/OpenMontage --skill faceswap -a claude-code

2Manually: put the files in place

~/.claude/skills/faceswap/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/faceswap/

From the same set28

The whole set →
video-understand calesthio This skill extracts video frames and transcribes audio locally with ffmpeg and Whisper. Use it to inspect video content without API keys. Claude Code CX Codex Cursor +1 1,300installs remotion calesthio Teaches AI agents toolkit-specific Remotion patterns, including custom transition shaders and 30 fps video rules. Claude Code CX Codex Cursor +1 1,200installs video-download calesthio Uses yt-dlp to fetch video, audio, subtitles, or URL metadata. Use it when you need a local file, a selected resolution, or details without downloading media. Claude Code CX Codex Cursor +1 1,200installs lottie-bodymovin calesthio Applies Disney's 12 animation principles to Lottie vector animations. Bridges After Effects setup with runtime JavaScript controls. Claude Code CX Codex Cursor +1 1,100installs create-video calesthio This skill turns a description into a finished video: write what you want to see, and HeyGen generates the script, picks an avatar, adds voiceover and editing. Good for quick demos, explainers and promos without tweaking every detail. Claude Code CX Codex Cursor +1 1,100installs video-toolkit calesthio Automates video creation: generates voiceovers, background music, animates talking heads, and composes scenes with Remotion. Requires Node.js, Python3, ffmpeg, and cloud GPU access (Modal or RunPod). Claude Code CX Codex Cursor +1 1,100installs text-to-speech calesthio Generates speech audio with HeyGen Starfish and lets you choose a voice, speed, and pitch. Useful for voiceovers, narration, and podcasts. Claude Code CX Codex Cursor +1 1,100installs bfl-api Black Forest Labs This skill helps connect BFL FLUX API for image generation and editing. It covers async requests, polling, rate limits, and webhooks. Claude Code CX Codex Cursor +1 1,000installs

Similar

omni-mcp cheaper-inference Connects an agent to the OmniRoute MCP server for request routing, memory, cache, and audit work. Use it when those operations need to be available as MCP tools. Claude Code CX Codex Cursor +1 1,100installs frontend-dev MiniMax-AI Orchestrates frontend development, motion design, AI-generated media, and conversion copy. Built for landing pages, marketing sites, and dashboards. Claude Code CX Codex Cursor +1 3,200installs microsoft-agent-framework official github Guides GitHub Copilot through building, updating, reviewing, and explaining Microsoft Agent Framework applications. It also covers migrations from Semantic Kernel and AutoGen. GitHub Copilot 1,900installs ctf-ai-ml ljagiello Provides AI and machine learning attack techniques for CTF competitions, from adversarial examples to LoRA weight inspection and prompt injection. Claude Code CX Codex Cursor +1 7,700installs market-sizing phuryn Skill for calculating market size using TAM, SAM, and SOM with top-down and bottom-up approaches. Helps validate market opportunity and prepare investor pitches. Claude Code CX Codex Cursor +1 3,000installs mem0-vercel-ai-sdk mem0ai Connects Mem0 memory to the Vercel AI SDK. It shows your agent how to retrieve and store context inside generateText and streamText calls. Claude Code CX Codex Cursor +1 508installs skill-creator official anthropics Creates and refines skills, then tests them with prompts, evaluations, and performance checks. Claude Code Claude.ai 414,180installs writing-for-agents Matt Pocock Guidance for writing skills and agent-facing documents. Use it when editing AGENTS.md, CLAUDE.md, or reference files reached from them. Claude Code 466,719installs

Questions about faceswap

How to install faceswap in Claude Code?

Run npx skills add calesthio/OpenMontage --skill faceswap -a claude-code.

What does faceswap do?

It sends a source photo and a target video to the HeyGen API to replace the face in the video.

What is required to run the skill?

You must export your HEYGEN_API_KEY environment variable. The workflow also requires publicly accessible links for the source face photo and target video.

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor