# vork

vork is a Claude Code skill that creates 3D stills, animation, and video with vork commands and scene.json. It handles rendering, lighting, filming, and visual effects.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1678 repo stars
- Author: voyager-so
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/voyager-so/vork/tree/HEAD/skills/vork/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/vork

## What it does

The vork skill guides an agent through making 3D stills, animation, and video for scenes, product shots, and visual effects. Work starts with `vork help`, while `vork init` creates a new scene. The command reference supplies fields and default values.

A shot is developed through a low-cost test render and an inspection of its largest visible flaw. Animation is reviewed as a contact sheet before a better still is approved and the final output is rendered. For camera placement, `vork ask` reports a node transform, bounds, and the fraction of the subject visible in frame.

A render must return exit zero and fresh metadata. Warnings, omissions, and substitutions are recorded, and the actual output is inspected before quality is reported. The skill points to `references/shot.md` for watchable shots and `references/assets.md` for primitive-built objects, HDRIs, textures, models, or fonts.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add voyager-so/vork --skill vork -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add voyager-so/vork --skill vork -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add voyager-so/vork --skill vork -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install voyager-so/vork skills/vork
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add voyager-so/vork --skill vork -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/voyager-so/vork --path skills/vork
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/vork/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/voyager-so/vork/tree/HEAD/skills/vork/SKILL.md

## When to use it
- create a 3D still from a scene
- set lighting and camera placement for a product shot
- measure an object's framing with `vork ask`
- review animation through a contact sheet
- inspect a render and record omissions

## Example prompts
- Create a new scene with `vork init`, then prepare a 3D still.
- Use `vork ask` to measure the camera placement and the subject's frame coverage.
- Make a draft animation render, review its contact sheet, and fix the largest visible issue.

## Similar
- [explainer-engaging](https://affpapa.org/en/nevibecode/skills/explainer-engaging.md) — skill · 3000 installs
- [teardown](https://affpapa.org/en/nevibecode/skills/teardown.md) — skill · ★ 3981 repo stars
- [perspective-illusion](https://affpapa.org/en/nevibecode/skills/perspective-illusion.md) — skill · ★ 541 repo stars
- [creator-toy-intro](https://affpapa.org/en/nevibecode/skills/creator-toy-intro.md) — skill · ★ 155 repo stars
- [videohub](https://affpapa.org/en/nevibecode/skills/videohub.md) — skill · ★ 699 repo stars
- [3d-animation-short-generator](https://affpapa.org/en/nevibecode/skills/3d-animation-short-generator.md) — skill · 3900 installs

---
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
