# run-longcat-avatar-video

run-longcat-avatar-video is a Claude Code skill that orchestrates talking avatar generation via draw-things-cli. It animates a portrait from sound input in LongCat-Video-Avatar 1.5.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 171 repo stars
- Author: drawthingsai
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/drawthingsai/local-code-community/tree/HEAD/.agents/skills/run-longcat-avatar-video/SKILL.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/run-longcat-avatar-video

## What it does

This skill prepares CLI execution pipelines for the LongCat-Video-Avatar 1.5 diffusion setup. It sets distillation values to 8 steps, CFG 1, and shift 7 at 25 frames per second. Clip lengths follow the strict 4k + 1 requirement. A standard standalone generation uses 93 frames. When processing extended speech recordings, it activates local AVC mode with 93 segment frames and 13 conditioning frames, yielding 80 unique frames per step.

Running the tool requires compiling `draw-things-cli` with Bazel inside the Draw Things source tree. The local models directory must contain the LongCat checkpoint (`i8x` or `q8p`), UMT5 text weights, the Wan 2.1 video VAE, and `whisper_large_v3_f16.ckpt`. Processing halts immediately if the Whisper checkpoint is absent because LongCat does not fetch it automatically. Audio inputs are pre-validated through `afinfo` to confirm valid duration and container decoding.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add drawthingsai/local-code-community --skill run-longcat-avatar-video -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/run-longcat-avatar-video/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/run-longcat-avatar-video/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add drawthingsai/local-code-community --skill run-longcat-avatar-video -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/run-longcat-avatar-video/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add drawthingsai/local-code-community --skill run-longcat-avatar-video -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/run-longcat-avatar-video/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install drawthingsai/local-code-community .agents/skills/run-longcat-avatar-video
```

2. **Manually: put the files in place**
- File: `.github/skills/run-longcat-avatar-video/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add drawthingsai/local-code-community --skill run-longcat-avatar-video -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/drawthingsai/local-code-community --path .agents/skills/run-longcat-avatar-video
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/run-longcat-avatar-video/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/drawthingsai/local-code-community/tree/HEAD/.agents/skills/run-longcat-avatar-video/SKILL.md

## When to use it
- render animated avatar videos from a still image and an audio file
- configure local LongCat-Video-Avatar 1.5 pipelines on Apple silicon
- process long speech files into segmented AVC chunks using 93/13 framing
- validate audio container integrity via afinfo before running diffusion

## Example prompts
- Generate an avatar clip using portrait.png and voice.wav with the LongCat i8x model
- Render an extended video using local AVC mode 93/13 for speech.mp3
- Check the local Whisper checkpoint and build a 93-frame clip without AVC

## Similar
- [ai-avatar-video](https://affpapa.org/en/nevibecode/skills/prime-skills-ai-avatar-video.md) — skill · 390700 installs
- [p-video-avatar](https://affpapa.org/en/nevibecode/skills/p-video-avatar.md) — skill · 14400 installs
- [avatar-video](https://affpapa.org/en/nevibecode/skills/avatar-video.md) — skill · 1200 installs
- [flyworks-avatar-video](https://affpapa.org/en/nevibecode/skills/flyworks-avatar-video.md) — skill · 385 installs
- [d-id-avatar-video](https://affpapa.org/en/nevibecode/skills/d-id-avatar-video.md) — skill · 131 installs
- [alibabacloud-avatar-video](https://affpapa.org/en/nevibecode/skills/alibabacloud-avatar-video.md) — skill · 125 installs

From the same set: [drawthingsai/local-code-community](https://affpapa.org/en/nevibecode/by/drawthingsai/local-code-community.md) — 20 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
