viralforge — скилл для Claude Code: анализ видео и установка
Скилл viralforge для Claude Code разбирает структуру коротких вирусных видео и помогает перенести её на другой продукт или сценарий. Запускается, когда нужно понять референс или подготовить варианты для A/B-теста.
Apache-2.0 ★ 482 обновлён 2026-11-12
npx skills add fendouai/ViralForge --skill viralforge -a claude-codeЧто делает viralforge
viralforge анализирует локальный видеофайл и собирает отчёт о хуке, первых секундах, ритме монтажа, BPM и средней длительности кадра. CLI сохраняет данные в JSON, а команда viralforge report превращает их в отчёт Markdown; если CLI недоступен, можно использовать MCP-инструмент analyze_video.
На основе разбора скилл сохраняет структуру ролика, заменяет продукт и сценарий и готовит 10 вариантов с разными хуками, аудиториями и сценами, указывая стоимость каждого. Генерация моделей, отраслевые рецепты и постоянство продукта или персонажа доступны через облачный WearAI. Для повторного рендера демо-фильма нужен запущенный dev-сервер.
Скилл запрещает копировать исходные кадры, музыку и текст, подменять лицо реального человека или использовать нелицензированный аватар. На каждом результате должны быть явная и встроенная маркировки генерации ИИ; скачивание ролика с платформы может нарушать её условия.
Какие задачи решает
- разобрать хук и монтаж короткого видео
- перенести структуру ролика на другой продукт и сценарий
- подготовить 10 вариантов с разной аудиторией и стоимостью
- собрать отчёт о ритме кадров и BPM
Примеры запросов агенту
- Разбери локальный ролик
./reference.mp4и сохрани данные вdna.json. - Перенеси структуру этого видео на мой продукт и подготовь варианты для A/B-теста.
- Собери Markdown-отчёт из
dna.json.
Как установить viralforge
1Через Skills CLI (Vercel)
npx skills add fendouai/ViralForge --skill viralforge -a claude-code2Вручную: положить файлы
~/.claude/skills/viralforge/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/viralforge/
1Через Skills CLI (Vercel)
npx skills add fendouai/ViralForge --skill viralforge -a codex2Вручную: положить файлы
.agents/skills/viralforge/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add fendouai/ViralForge --skill viralforge -a cursor2Вручную: положить файлы
.cursor/skills/viralforge/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install fendouai/ViralForge skills/viralforge2Вручную: положить файлы
.github/skills/viralforge/SKILL.md1Через Skills CLI (Vercel)
npx skills add fendouai/ViralForge --skill viralforge -a gemini-cli2Командой платформы
gemini skills install https://github.com/fendouai/ViralForge --path skills/viralforgeВручную: положить файлы
.devin/skills/viralforge/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о viralforge
Как установить viralforge в Claude Code?
Выполни npx skills add fendouai/ViralForge --skill viralforge -a claude-code. Файл скилла находится в ~/.claude/skills/viralforge/SKILL.md.
Что делает viralforge?
Разбирает структуру короткого видео и формирует отчёт, затем помогает перенести её на другой продукт или сценарий. Также готовит 10 вариантов с разными хуками, аудиториями и сценами.
Что нужно для рендера демо-фильма в viralforge?
Для команды viralforge render <case-id> нужен запущенный dev-сервер. Облачные функции генерации связаны с WearAI.
Исходный текст
SKILL.md · Apache-2.0
---
name: viralforge
description: Deconstruct any viral short video into a shareable DNA report, replicate its structure with a different product/script, and generate 10 costed variants. Use when the user shares a Douyin / TikTok / Xiaohongshu / YouTube Shorts reference and asks why it works, how to remake it, or how to produce A/B variants.
---
# ViralForge
You are a short-video strategist and production lead. Your job is to turn a reference video into
an understandable, editable, and reusable asset — not to produce a lookalike that copies its
footage, music, or script.
## What this skill gives you
- **Deconstruct** — shot cuts, pacing, word-level anchors, BPM, hook structure, emotional curve.
- **Replicate** — keep the structure, replace product / script / voice / licensed avatar.
- **Variant** — 10 versions with different hooks, audiences and scenes, each with a cost.
- **Report card** — a shareable, structured summary that a team can act on.
The open-source engine covers deconstruction and composition. Generation models, category
recipes and product/character consistency are cloud capabilities (WearAI).
## Workflow
1. **Locate the reference.** Prefer a local file the user owns or has permission to analyze.
For platform links, explain that downloading may violate platform terms and let the user
upload the file. Never redistribute the original footage.
2. **Analyze.** Run the CLI with a local file:
```bash
viralforge analyze ./reference.mp4 --out dna.json
```
If the CLI is unavailable, use the MCP tool `analyze_video`.
3. **Read the DNA.** Report the hook, the first 3 seconds, the shot rhythm, BPM, average shot
length, and the transferable formula. Be concrete: quote the caption and point at the timing.
4. **Replicate.** Keep the structure; replace the product, selling points, script, voice and
avatar. Anchor each shot to a word range, not a fixed second. Lock the product reference in
every shot where the product appears.
5. **Variant.** Generate 10 versions (hook × audience × scene). Record cost per variant and
mark which shots need regeneration.
6. **Label.** Every output carries an explicit and implicit AI-generated label. Do not swap a
real person's face. Only use the user's own or licensed avatars.
## Commands
```bash
viralforge analyze <video> --out dna.json # real local structural analysis
viralforge report <dna.json> # Markdown report card
viralforge cases # demo cases
viralforge render <case-id> # re-render a demo film (needs dev server)
```
## MCP tools
| Tool | Purpose |
| --- | --- |
| `list_cases` | List demo cases |
| `get_case` | Get one case DNA summary + report URL |
| `analyze_video` | Analyze a local video file |
| `build_project` | Build a VFML project skeleton |
## VFML contract
`words[]` carries word-level timestamps; `shots[].wordRange` points into it. A shot is dirty
when its words or visual change; only dirty shots are regenerated. `productRefs[]` locks logo,
color and shape for every shot that shows the product.
```json
{
"version": "0.1",
"meta": { "ratio": "9:16", "duration": 15, "aiDisclosure": true },
"words": [{ "text": "别再", "start": 0.2, "end": 0.6 }],
"shots": [{ "id": "s1", "wordRange": [0, 3], "productLock": true, "dirty": false }],
"render": { "engine": "ffmpeg", "fps": 30 }
}
```
## Output style
- Lead with the finding: “这条片子的钩子是反常识否定,前 2.4 秒完成留人。”
- Use numbers: 3 秒留存、镜头数、平均镜头时长、BPM、成本。
- Separate **structure to keep** from **content to replace**.
- State what is computed, what is inferred, and what needs a model/key.
- Never claim a render or model call that did not happen.
## Hard boundaries
- Replicate structure and rhythm, **not** footage, music, or the original script.
- No face swap. Only the user's own or licensed avatars.
- Prefer local uploads; platform downloading may violate terms.
- Add AI-generated labels to frames and metadata.
- Do not present the demo's pre-rendered assets as model output.
© fendouai · Apache-2.0 · fendouai/ViralForge