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.
npx skills add calesthio/OpenMontage --skill faceswap -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/faceswap/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/faceswap/
1Skills CLI (Vercel)
npx skills add calesthio/OpenMontage --skill faceswap -a codex2Manually: put the files in place
.agents/skills/faceswap/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add calesthio/OpenMontage --skill faceswap -a cursor2Manually: put the files in place
.cursor/skills/faceswap/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install calesthio/OpenMontage faceswap2Manually: put the files in place
.github/skills/faceswap/SKILL.md1Skills CLI (Vercel)
npx skills add calesthio/OpenMontage --skill faceswap -a gemini-cli2Platform CLI
gemini skills install https://github.com/calesthio/OpenMontage --path .claude/skills/faceswapManually: put the files in place
.devin/skills/faceswap/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add calesthio/OpenMontage --skill faceswap -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set28
The whole set →Similar
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.