Agent skill

Wan Scail Replacement

by artokun in artokun/comfyui-mcp

SCAIL-2 in-video character replacement on WAN 2.1. An agent skill from artokun/comfyui-mcp.

MITAuto-check passedAI & LLM Engineering

Install Wan Scail Replacement

skills CLI
$ npx skills add artokun/comfyui-mcp --skill wan-scail-replacement -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install artokun/comfyui-mcp wan-scail-replacement --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/artokun/comfyui-mcp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugin/skills/wan-scail-replacement .claude/skills/wan-scail-replacement && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
wan-scail-replacement
GitHub stars
803
Token cost
~1.2k tokens
SKILL.md length
647 words
Files
1
Skills in repo
42
Repo updated
First seen
Licence
MIT

At a glance

SCAIL-2 in-video character replacement on WAN 2.1. An agent skill from artokun/comfyui-mcp.

  • Tasks that involve Diffusion and image models
  • SKILL.md covers The one rule that costs a…, Tuning trade-off: distill LoRA…, Don't "fix" colour with… and Models (reference set), plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Wan Scail Replacement is an agent skill from artokun/comfyui-mcp. SCAIL-2 in-video character replacement on WAN 2.1. WanSCAILToVideo + SCAIL2ColoredMask + SAM3, the reference-image framing→scale rule, and the tuning/compositing pitfalls

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering Diffusion and image models. The repository describes itself as: Local-first, agent-native control plane for ComfyUI — MCP server + sidebar agent that generates images, video & audio, authors and runs workflows, and edits your live graph in… The licence is MIT.

When your agent uses it

  • Tasks that involve Diffusion and image models

Example prompts

  • “/wan-scail-replacement”

What it can do on your machine

Read from SKILL.md and the folder at commit 6ad6fc0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Wan Scail Replacement loads about 1.2k tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 647 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~48
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from artokun/comfyui-mcp at commit 6ad6fc0, republished under its MIT licence (© artokun). 647 words, ~1,186 tokens.

Download SKILL.mdSave it as .claude/skills/wan-scail-replacement/SKILL.md (or your agent's skills folder).
name
wan-scail-replacement
description
SCAIL-2 in-video character replacement on WAN 2.1. WanSCAILToVideo + SCAIL2ColoredMask + SAM3, the reference-image framing→scale rule, and the tuning/compositing pitfalls
globs
**/*.json

SCAIL-2 In-Video Character Replacement (WAN 2.1)

SCAIL-2 (zai-org, on WAN 2.1 14B) replaces the person in a driving video with a character you supply as a reference image, end-to-end, with no pose maps, and with multi-character support. It is the successor to WAN Animate / motion transfer for the "swap the subject, keep the motion" job. The official ComfyUI template is video_wan21_scail2_character_replacement_int8, built around WanSCAILToVideo (+ SCAIL2ColoredMask) with a SAM3 mask driving where the character goes.

This skill documents the non-obvious behaviours that cost a full multi-minute render to discover. It is not a from-scratch graph. Start from the official template and apply the guidance below.

The one rule that costs a re-render: reference framing controls SCALE

In replacement_mode: true, the reference image's FRAMING controls the output character's SIZE as well as its appearance. The SAM3 mask controls where the character is placed; the reference image controls how large.

Measured on a 720x1280 driving clip where the subject occupied ~30% of frame height (subject bbox 363 px):

Reference framingPerson bbox in outputvs driving subject
Full-bleed portrait (person ~93% of frame)621 px1.71x oversized
Reframed (person ~34% of frame)364 px1.003x — correct

After reframing, top/bottom registration matched the driving subject within 1 px (the character stands on the same ground plane at the same height). Pose transfer was correct in both cases. Only the scale was wrong, which makes it easy to misread as "the model works" until you A/B against the source.

Guidance: pad or reframe the reference before you render.

Pad/reframe the reference image onto a canvas at the working resolution so the person occupies roughly the same fraction of frame height as the subject in the driving video. A full-bleed portrait reference against a wide-shot driving clip renders the character oversized in proportion to the framing mismatch.

It is a trap because the template's on-canvas notes do not state it, and it does not show up in the popular Civitai motion-transfer workflows. Those run animation mode, where the reference legitimately fills the frame.

Tuning trade-off: distill LoRA strength / shift leaks driving-subject detail

Running the lightx2v distill LoRA at 0.8 with ModelSamplingSD3 shift 5 (the settings the popular Civitai workflow uses) improves colour and detail versus 1.0 / shift 8. It also increases adherence to the driving video enough that original-subject details bleed onto the replacement character. In one run the original golfer's neon-yellow shoe appeared on a replacement character who wears white shoes in the reference (same seed, same reference, only those two params changed). If you see source details you didn't ask for, raise the LoRA strength / shift back toward 1.0 / shift 8.

Show full SKILL.md (210 more words)Show less

Don't "fix" colour with post-hoc compositing — it's a regression

The raw SCAIL-2 output shows a measurable colour error (background ~-5 per channel from the VAE round-trip; the character loses red ~2.4x faster than green, which reads as a slight green cast). It is tempting to composite the generated character back over the original plate through the SAM3 mask to "correct" it. Don't. It measures better but looks worse:

  • The mask boundary produces an obvious halo.
  • Layering the original plate's props (e.g. a golf club) over generated hands severs the grip relationship the model had solved coherently.

SCAIL-2 resolves colour, edges, grip and occlusion jointly; correcting any one of them in isolation breaks the others. Leave the raw output alone.

Models (reference set)

The template's int8 build was exercised with:

  • wan2.1_14B_SCAIL_2_int8_convrot, the SCAIL-2 model
  • wan2.1_SCAIL_2_DPO_lora_bf16, the DPO LoRA
  • lightx2v_I2V_14B_480p_cfg_step_distill_rank64_bf16, the distill LoRA (see tuning note)
  • Wan2_1_VAE_bf16
  • umt5_xxl_fp8_e4m3fn_scaled, the text encoder
  • clip_vision_h
  • sam3.1_multiplex_fp16, the SAM3 mask model

VRAM: ~22.2 GB peak at 576x1024 / 81-frame chunks on a 24 GB card.

See also

  • wan-t2v-video, wan-flf-video for other WAN 2.x video pipelines
  • director for multi-shot scene direction for video pipelines

Sources

  • Official: none found.
  • Empirical: sampler values, wiring, and prompt notes from working graphs in packs/ and observed renders; not a vendor prompting guide.

© artokun, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugin/skills/wan-scail-replacement of artokun/comfyui-mcp.

Open the folder on GitHubat commit 6ad6fc0

Compare with similar skills

Wan Scail Replacement next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Wan Scail Replacement compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wan Scail Replacement this skillartokun/comfyui-mcp803—~1.2kAutomated safety check: PassMIT
Adapt New Diffusion Modelintel/auto-round1.6k—~2.8kAutomated safety check: PassApache-2.0
Add Pipelineverl-project/verl-omni1.2k—~1kAutomated safety check: PassApache-2.0
Comfyui AnimatoolShiroEirin/comfyui-good-anima481—~4.6kAutomated safety check: PassGPL-3.0
Stage1 Add VaeEnd2End-Diffusion/diffusion-bench105—~1.1kAutomated safety check: PassNone
Comfyui Agent Skill MieMieMieeeee/comfyui-agent-skill116—~3.9kAutomated safety check: PassApache-2.0

Similar skills

  • Official

    Adapt AutoRound to support a new diffusion model architecture (DiT, UNet, hybrid AR+DiT).

    1.6k GitHub stars~2.8k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Add Pipeline

    verl-project/verl-omni

    Router for adding a diffusion or omni pipeline to verl-omni.

    1.2k GitHub stars~1k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Comfyui Animatool

    ShiroEirin/comfyui-good-anima

    Route ALL Anima image generation: validate Danbooru hard anchors, form visual brief, assemble English prompts and args, then load comfyui-manager for workflow execution.

    481 GitHub stars~4.6k tokensUpdated 3 mo ago
    AI & LLM EngineeringAuto-check passed
  • Stage1 Add Vae

    End2End-Diffusion/diffusion-bench

    Add a new HuggingFace-supported VAE to the stage1 tokenizer pipeline.

    105 GitHub stars~1.1k tokensUpdated 3 mo ago
    AI & LLM EngineeringAuto-check passed
  • Comfyui Agent Skill Mie

    MieMieeeee/comfyui-agent-skill

    Agent skill for running registered ComfyUI workflows through a stable CLI, and for importing a user's own ComfyUI workflow into their private registry after review.

    116 GitHub stars~3.9k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Comfyui Node Adder

    nixified-ai/flake

    Adds new custom nodes to the ComfyUI Nix project, including npins fetching, dependency resolution in package.nix, disabling impure pip installs, and verifying the Nix build.

    841 GitHub stars~806 tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed

More from artokun/comfyui-mcp

All 42 skills in this repo
  • AI Toolkit Trainer

    artokun/comfyui-mcp

    Train custom LoRAs with ostris AI-Toolkit. An agent skill from artokun/comfyui-mcp.

    803 GitHub stars~2.7k tokensUpdated 6 days ago
    Auto-check passed
  • Anima Base

    artokun/comfyui-mcp

    Anime/illustration text-to-image (ANIMA 1.0, ~2B Cosmos DiT).

    803 GitHub stars~4k tokensUpdated 6 days ago
    Auto-check passed
  • Civitai

    artokun/comfyui-mcp

    Discover Civitai models with the BUILT-IN downloadmodel action:"searchcivitai" and install/generate them locally.

    803 GitHub stars~1.1k tokensUpdated 6 days ago
    Auto-check passed
  • Color Correction

    artokun/comfyui-mcp

    Diagnose and fix video/image color OBJECTIVELY with the getimage (action:"analyzecolor") tool (scopes/stats such as black/white points, contrast, saturation, clipping, cast) instead of eyeballing a…

    803 GitHub stars~2.4k tokensUpdated 6 days ago
    Auto-check passed
  • Comfyui Frontend Extensions

    artokun/comfyui-mcp

    Authoring ComfyUI v2 frontend extensions with @comfyorg/extension-api, covering defineNode/defineExtension/defineWidget, shell UI (sidebar tabs, commands, hotkeys), typed events, and handles.

    803 GitHub stars~5.4k tokensUpdated 6 days ago
    Auto-check passed
  • Comfyui Launch Flags

    artokun/comfyui-mcp

    Pick the right ComfyUI startup flags for VRAM, attention, caching, and speed.

    803 GitHub stars~3.1k tokensUpdated 6 days ago
    Auto-check passed

Questions about Wan Scail Replacement

What does Wan Scail Replacement do?

SCAIL-2 in-video character replacement on WAN 2.1. An agent skill from artokun/comfyui-mcp. Wan Scail Replacement is an agent skill from artokun/comfyui-mcp.1.

When should I use Wan Scail Replacement?

Wan Scail Replacement fits situations like: tasks that involve Diffusion and image models.

How do I install Wan Scail Replacement in Claude Code?

Run `npx skills add artokun/comfyui-mcp --skill wan-scail-replacement -a claude-code`. Or copy the skill folder (plugin/skills/wan-scail-replacement in artokun/comfyui-mcp) into .claude/skills/wan-scail-replacement in your project. Claude Code loads it when a task matches its description.

How do I install Wan Scail Replacement in Codex?

Run `npx skills add artokun/comfyui-mcp --skill wan-scail-replacement -a codex`. Or copy the skill folder (plugin/skills/wan-scail-replacement in artokun/comfyui-mcp) into .agents/skills/wan-scail-replacement in your project. Codex loads it when a task matches its description.

Can I use Wan Scail Replacement in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add artokun/comfyui-mcp --skill wan-scail-replacement -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wan-scail-replacement, .gemini/skills/wan-scail-replacement, .github/skills/wan-scail-replacement and .opencode/skills/wan-scail-replacement in your project.

What does Wan Scail Replacement need to run?

SKILL.md names no scripts, command-line tools or credentials: Wan Scail Replacement is instructions for the agent only.

Does Wan Scail Replacement access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Wan Scail Replacement safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Wan Scail Replacement use?

Wan Scail Replacement is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Wan Scail Replacement use?

About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Wan Scail Replacement?

Skills that share tags, products or a category with Wan Scail Replacement: Adapt New Diffusion Model (intel/auto-round, 1.6k stars), Add Pipeline (verl-project/verl-omni, 1.2k stars), Comfyui Animatool (ShiroEirin/comfyui-good-anima, 481 stars) and Stage1 Add Vae (End2End-Diffusion/diffusion-bench, 105 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wan Scail Replacement?

artokun (a GitHub user) maintains it in artokun/comfyui-mcp, which has 803 GitHub stars. The repository holds 42 skills in this directory. The repository was last updated on October 5, 2026.

Source: artokun/comfyui-mcp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.