# env-setup

env-setup is a Claude Code skill that checks the machine setup for the video-agent-kit plugin and installs supported missing dependencies.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 297 repo stars
- Author: wwwzhouhui
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/wwwzhouhui/skills_collection/tree/HEAD/video-agent-kit/skills/env-setup/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/env-setup

## What it does

env-setup inspects FFmpeg and ffprobe, required codecs and filters, Python packages in Claude Code’s interpreter, and fonts that contain Chinese glyphs. It also checks which speech channel is available. The script reports requirements and install commands for the current operating system; `--fix` installs items it can handle automatically.

Run `python3 <plugin_root>/skills/env-setup/scripts/env_doctor.py` to inspect the setup, or add `--fix` to install automatic fixes. The environment needs Python 3.10 or later, the packages `mcp`, `requests`, `opencv-python-headless`, `numpy`, `pillow`, `jieba`, `fonttools`, and `scenedetect`, plus FFmpeg with `libx264`, `aac`, `libmp3lame`, `libass`, and `libfreetype`. A font without Chinese glyphs can render subtitles as square boxes. Outside ZCode, speech features need cloud credentials or access to Speech MCP.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add wwwzhouhui/skills_collection --skill env-setup -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add wwwzhouhui/skills_collection --skill env-setup -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add wwwzhouhui/skills_collection --skill env-setup -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install wwwzhouhui/skills_collection video-agent-kit/skills/env-setup
```

2. **Manually: put the files in place**
- File: `.github/skills/env-setup/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add wwwzhouhui/skills_collection --skill env-setup -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/wwwzhouhui/skills_collection --path video-agent-kit/skills/env-setup
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/env-setup/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/wwwzhouhui/skills_collection/tree/HEAD/video-agent-kit/skills/env-setup/SKILL.md

## When to use it
- check which video-agent-kit dependencies are missing
- diagnose an `Unknown encoder 'libx264'` failure
- install missing Python packages and FFmpeg
- find why Chinese subtitles render as square boxes

## Example prompts
- Check the environment for video-agent-kit before the first edit.
- Install the missing dependencies for this project.
- Find out why `speech_transcribe` returns a 401 error.

## Similar
- [setup-python-env](https://affpapa.org/en/nevibecode/skills/setup-python-env.md) — skill · 794 installs
- [hf-cloud-python-env-setup](https://affpapa.org/en/nevibecode/skills/hf-cloud-python-env-setup.md) — skill · 690 installs
- [env-setup-wizard](https://affpapa.org/en/nevibecode/skills/env-setup-wizard.md) — skill · 308 installs
- [video-editor-setup](https://affpapa.org/en/nevibecode/skills/video-editor-setup.md) — skill · ★ 470 repo stars
- [yt-dlp](https://affpapa.org/en/nevibecode/skills/yt-dlp.md) — skill · 2100 installs
- [video-understand](https://affpapa.org/en/nevibecode/skills/video-understand.md) — skill · 1500 installs

From the same set: [wwwzhouhui/skills_collection](https://affpapa.org/en/nevibecode/by/wwwzhouhui/skills_collection.md) — 7 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
