К основному содержанию
плагин официальный · Anthropic

quickdesign — плагин для Claude Code: генерация AI-видео и картинок

Скилл для CLI QuickDesign: запускает генерацию видео и изображений через Seedance 2.0, Sora 2, Kling и Nano Banana 2 прямо из Claude Code.

MIT ★ 4 931 обновлён 2026-10-24

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add anthropics/claude-plugins-community
/plugin install quickdesign@claude-community
Открыть на GitHub

Что делает quickdesign

Плагин ставит в Claude Code скилл для работы с @quickdesign/cli: генерация видео (Seedance 2.0 R2V как универсальный вариант для UGC, говорящих аватаров и промо-роликов, Sora 2, Kling) и картинок (Nano Banana 2 с несколькими референсами). Внутри — SKILL.md, папки references, pipelines и models с карточками под каждую модель, включая проверку анатомии и склейку нескольких сегментов с одним голосом.

Сам бинарник quickdesign плагин не несёт: его ставят отдельно через npm, иначе команды генерации не запустятся. Плагин только раскладывает файлы скилла в ~/.claude/plugins/quickdesign/ и обновляется командой /plugin marketplace update без повторного quickdesign init.

Мульти-сегментные видео-пайплайны требуют ffmpeg и ffprobe — без них часть сценариев не соберётся.

Какие задачи решает

  • собрать UGC-ролик или говорящего аватара из референсов
  • сгенерировать карточку товара с несколькими референс-изображениями через Nano Banana 2
  • склеить многосегментное видео с одним голосом по всем частям
  • подобрать модель генерации (Seedance, Sora 2, Kling) под конкретную задачу
  • прогнать видео через апскейл после генерации

Примеры запросов агенту

  • Сделай UGC-видео товара через Seedance 2.0 по этим двум референс-картинкам
  • Собери промо-ролик в формате 9:16 на Kling с длительностью 5 секунд
  • Сгенерируй студийное фото браслета на белом фоне через Nano Banana 2

Как установить quickdesign

Через маркетплейс плагинов

/plugin marketplace add anthropics/claude-plugins-community
/plugin install quickdesign@claude-community

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о quickdesign

Как установить quickdesign в Claude Code?

Выполните /plugin marketplace add anthropics/claude-plugins-community, затем /plugin install quickdesign@claude-community.

Что делает quickdesign?

Это скилл для CLI QuickDesign, который запускает генерацию AI-видео (Seedance 2.0, Sora 2, Kling) и изображений (Nano Banana 2) прямо из Claude Code, включая UGC-ролики и мульти-референсные композиции.

Нужно ли что-то ещё для работы quickdesign?

Да, сам бинарник @quickdesign/cli нужно поставить отдельно через npm, а для мульти-сегментных видео-пайплайнов требуются ffmpeg и ffprobe.

Исходный текст

quickdesign · MIT
# @quickdesign/cli

[![npm](https://img.shields.io/npm/v/@quickdesign/cli.svg?color=cb3837&label=npm)](https://www.npmjs.com/package/@quickdesign/cli)
[![node](https://img.shields.io/node/v/@quickdesign/cli.svg?color=339933)](https://www.npmjs.com/package/@quickdesign/cli)
[![license](https://img.shields.io/npm/l/@quickdesign/cli.svg?color=blue)](./LICENSE)

Command-line interface for [QuickDesign](https://quickdesign.io) — built so anyone (or any Claude Code agent) can drive the full QuickDesign stack from a terminal:

- **Generate** AI images (Nano Banana, GPT Image) and videos (Sora 2, Kling, **Seedance 2.0** including reference-to-video, UGC) — start, poll, save to disk in one command.
- **Smart Ad Creator** — turn a product URL into a single concept ad, or fan out 16 concepts in parallel (Advantage+).
- **Spy Brands** — query the competitor ad library: per-brand ads, cross-brand winners, this-week trends.
- **Brand DNA** — scrape a website's colors / fonts / logo, or run the full Claude-streamed Brand DNA extraction (voice, audience, offer).
- **Designs** — list, fetch, download, or archive your saved creatives directly from PostgREST.
- **Ship-ready** — JSON to stdout, diagnostics to stderr, exit codes for pipelines, optional `--human` pretty-print.

## Install

There are two ways to install. Pick whichever matches how you use Claude Code today.

### Option A — npm (CLI binary + skill bundle, classic)

```bash
npm install -g @quickdesign/cli
quickdesign init        # one-time bootstrap: doctor + skill + login
```

This installs the `quickdesign` binary AND copies the Claude Code skill into `~/.claude/skills/quickdesign/`. Best for standalone CLI users + scripted/CI use.

### Option B — Claude Code plugin marketplace

```text
# Inside Claude Code:
/plugin marketplace add ottasilver/quickdesign-cli
/plugin install quickdesign@quickdesign

# Still need the binary on PATH for actual generation:
npm install -g @quickdesign/cli
```

The plugin distributes the skill (`SKILL.md` + `references/` + `pipelines/` + `models/`) under `~/.claude/plugins/quickdesign/`. New skill versions reach you whenever you run `/plugin marketplace update` — no manual `quickdesign init --skill-only --force` required. The `quickdesign` binary itself still ships via npm; the plugin keeps distribution lean by not bundling node binaries.

If you already used Option A, you can keep it — the plugin install lives alongside `~/.claude/skills/quickdesign/` without conflict. For a clean switch: `rm -rf ~/.claude/skills/quickdesign` after the plugin is installed.

Requires Node.js ≥ 18.17 either way.

> **`init` does NOT run automatically after `npm install`.** That would break CI/scripted installs and silently mutate `~/.claude/skills/` without consent. You run it once, on purpose, the first time you use the CLI on a machine. After that, every `quickdesign …` call just works.

`quickdesign init` does three things, each independently skippable:

1. **Doctor** — checks for `ffmpeg` / `ffprobe` (needed for multi-segment video pipelines). Warns + prints install hints if missing; never blocks.
2. **Skill install** — copies the bundled Claude Code skill into `~/.claude/skills/quickdesign/`. Refuses to overwrite existing files unless `--force`.
3. **Auth login** — opens the browser handshake (or falls back to terminal paste; see [Authentication](#authentication)).

```bash
quickdesign init                       # full bootstrap
quickdesign init --skill-only          # just install the skill
quickdesign init --no-skill            # skip skill, just doctor + login
quickdesign init --no-auth             # CI / scripted setups
quickdesign init --no-doctor           # skip ffmpeg check
quickdesign init --force               # overwrite existing skill files
quickdesign init --skill-dir ~/my/skills/quickdesign   # custom target
```

For one-shot use without a global install:

```bash
npx -y @quickdesign/cli init
```

## Quickstart

```bash
# After `quickdesign init` you're already logged in. Verify:
quickdesign whoami

# --- Spy Brands ---------------------------------------------------------
quickdesign spy brands --search "Kizik" --human
quickdesign spy brand-ads <brand-id> --status active --sort most_impressions --limit 5

# --- Image: studio shot, save to disk -----------------------------------
quickdesign image generate \
  --prompt "studio photo of a silver bracelet on white background" \
  --model nano-banana-2 --wait -o ./bracelet.jpg

# --- Video: Seedance 2.0 r2v with two reference images ------------------
quickdesign video generate --provider seedance \
  --reference-image https://cdn.example.com/bracelet.jpg \
  --reference-image https://cdn.example.com/model.jpg \
  --prompt "@Image2 wearing @Image1, slow catwalk" \
  --aspect-ratio 9:16 --duration 5 --wait -o ./catwalk.mp4

# --- Smart Ad Creator: 16 concepts in parallel --------------------------
quickdesign ad-creator advantage-plus \
  --product-url https://kizik.com/products/bowen-black --wait -o ./ads
ls ./ads/   # one .jpg per completed concept

# --- Brand DNA (Claude-streamed) ----------------------------------------
quickdesign brand dna https://kizik.com

# --- Your designs -------------------------------------------------------
export QUICKDESIGN_SUPABASE_ANON_KEY="<your supabase anon key>"
quickdesign design list --limit 10
quickdesign design download <id> -o ./out.jpg
```

## Authentication

`quickdesign login` opens the default browser, waits for the QuickDesign web app to hand back a token, and writes it to:

```
~/.config/quickdesign/auth.json  (0600)
```

The file holds the access token + refresh token, so subsequent commands transparently refresh expired sessions without re-prompting.

**Manual paste fallback.** Some environments (corporate VPN, container, remote SSH, browsers that block HTTPS→localhost) can't deliver the token over the loopback handshake. While `quickdesign login` is running, the browser tab also displays the access token in a copy box — paste it into the same terminal where `login` is waiting, press Enter, and it accepts the token directly. Whichever path finishes first wins; the other is cancelled cleanly.

For CI, skip the browser entirely:

```bash
QUICKDESIGN_TOKEN=<supabase-jwt> quickdesign spy brands
# or
quickdesign login --token <supabase-jwt>
# or
cat my-token.txt | quickdesign login --token-stdin
```

Logout / inspect config:

```bash
quickdesign logout
quickdesign auth config show
quickdesign auth config set baseUrl http://localhost:3001   # local dev
```

## Environment variables

| Variable                        | Purpose                                                                                             |
| ------------------------------- | --------------------------------------------------------------------------------------------------- |
| `QUICKDESIGN_BASE_URL`          | Override API base URL (default `https://app.quickdesign.io`)                                        |
| `QUICKDESIGN_TOKEN`             | Override the stored token (takes precedence over `auth.json`)                                       |
| `QUICKDESIGN_SUPABASE_URL`      | Override Supabase REST base (default: prod project). Used only by `design` subcommands.             |
| `QUICKDESIGN_SUPABASE_ANON_KEY` | Supabase API key — accepts both the legacy anon JWT and the new `sb_publishable_...` key. Used by `design` subcommands (PostgREST-direct; RLS scopes to user) and token refresh. A prod default ships in the binary; override here or via `quickdesign auth config set supabase_anon_key <key>` (e.g. after a key rotation). |

## Commands

### `init` — bootstrap

| Command | Notes |
| --- | --- |
| `init [--force] [--skill-only] [--no-skill] [--no-auth] [--no-doctor] [--skill-dir <path>]` | One-shot setup: ffmpeg doctor + bundled Claude Code skill + browser login |

### `auth`

| Command                      | Notes                                              |
| ---------------------------- | -------------------------------------------------- |
| `login`                      | Browser OAuth + parallel terminal-paste fallback (CI flags: `--token`, `--token-stdin`, `--timeout <ms>`) |
| `logout`                     | Delete the stored token                            |
| `whoami`                     | Show the active user, token expiry, live ping      |
| `auth config show|get|set|path` | Inspect / tweak the config file                 |

### `spy` — Spy Brands

| Command | Notes |
| --- | --- |
| `brands [--search] [--limit]` | List / search brands |
| `brand <brandId>` | Fetch one brand |
| `brand-ads <brandId> [--status] [--sort] [--limit]` | List a brand's ads |
| `best-ads [--limit] [--category-id] [--status]` | Top ads cross-brand |
| `search <query>` | Convenience alias for brand search |
| `for-you` | Personalized feed (auth required) |
| `trending` | Trending feed |

### `image`

| Command | Notes |
| --- | --- |
| `generate --prompt … [--model] [--wait] [-o path]` | Async start + optional poll + optional save |
| `status <requestId>` | One-shot status check |
| `wait <requestId> [--timeout] [-o path]` | Resume polling on a job started earlier and optionally download |
| `result <requestId> [-o path]` | Fetch finished job result |
| `history [--limit]` | List past image jobs |
| `models` | Discover available image models |

### `video` — Sora 2 / Kling / Seedance 2.0 / UGC

| Command | Notes |
| --- | --- |
| `generate --provider <sora2\|kling\|seedance\|ugc> --prompt … [--image \| --reference-image…] [--audio] [--duration] [--aspect-ratio] [--resolution] [--wait] [-o path]` | Start + optional poll + optional save. Seedance 2.0 r2v is activated by `--reference-image` (1+). UGC requires both `--image` and `--audio`. |
| `status <provider> <jobId>` | One-shot status check |
| `wait <provider> <jobId> [--timeout] [-o path]` | Resume polling on a job started earlier (default timeout 30 min) and optionally download |
| `history <provider> [--limit] [--status]` | List jobs for a provider |
| `upscale --video <url> --provider <topaz\|bytedance> [--factor] [--wait] [-o path]` | Kick off a Topaz/ByteDance video upscale |
| `upscale-status <jobId>` | One-shot status check |
| `upscale-wait <jobId> [--timeout] [-o path]` | Resume polling on an upscale job |
| `upscale-history [--limit]` | List upscale jobs |
| `subtitle <video> [--style default\|tiktok\|minimal\|karaoke\|reels-pop] [--language] [--font-name] [--font-size] [--position] [--wait] [-o path]` | Burn karaoke-style auto-subtitles into a video (ElevenLabs ASR + libass; ~$0.03/min). Default preset: Montserrat 65px bold, 5 words/line, bottom-positioned, yellow highlight. Local files are auto-uploaded to R2. |
| `subtitle-status <jobId>` | One-shot status check |
| `subtitle-history [--limit]` | List subtitle jobs |

### `brand`

| Command | Notes |
| --- | --- |
| `scrape <url>` | Sync scrape — returns colors, fonts, logo, description |
| `dna <url> [--output json\|events]` | Full Brand DNA via Claude (SSE). Default prints the final JSON; `--output events` emits NDJSON of every frame (agents) |

### `ad-creator` — Smart Ad Creator

| Command | Notes |
| --- | --- |
| `concepts [--human]` | List available concept slugs |
| `analyze <product-url>` | Extract product name, images, features, audience |
| `generate --product-url --concept <slug> [--brand-kit] [--wait] [-o path]` | Single-concept async job |
| `advantage-plus --product-url [--brand-kit] [--wait] [-o dir]` | Fan out 16 concepts. With `-o <dir>`, every completed concept is saved to `<dir>/<concept>.jpg` |
| `status <requestId>` | One-shot status check |
| `wait <requestId> [--timeout] [-o path]` | Resume polling on a single ad job |
| `batch-status <batchId>` | One-shot batch status |
| `batch-wait <batchId> [--timeout] [-o dir]` | Resume polling on an advantage+ batch + download every completed concept |

### `design`

PostgREST-direct (user JWT + RLS). Requires `QUICKDESIGN_SUPABASE_ANON_KEY`.

| Command | Notes |
| --- | --- |
| `list [--limit] [--offset] [--category] [--assets-only] [--archived]` | Your designs (most recent first) |
| `get <id>` | Full row |
| `delete <id>` | Soft-delete (sets `isArchived = true`) |
| `download <id> -o <path>` | Save the design's image or video to disk |

### `meta` — Deploy to Meta + analytics

| Command | Notes |
| --- | --- |
| `accounts` / `pages` / `pixels` | Connected ad accounts, FB pages, pixels |
| `campaigns [--account]` / `adsets` | Campaign / ad-set listing |
| `insights` / `report` / `radar` | Performance analytics (radar: `--compute` for fresh grades) |
| `publish --account … --page … --design … [--wait]` | Publish designs as PAUSED Meta ads |
| `publish-status <jobId>` | Poll a publish job |
| `settings` | Stored Meta account settings |

### `cost` — credit pricing

| Command | Notes |
| --- | --- |
| `cost [slug] [--category <c>] [-d <sec>] [-r <res>] [--num <n>] [--json]` | Model pricing from the live registry; with a slug + params computes the exact credit cost |

## Long-running jobs

Video generations and Advantage+ batches commonly take 5–15 minutes. The CLI is polling-only (no inbound webhook into your laptop), so you have three options:

**1. Block in the foreground.** Pass `--wait -o ./out.mp4` and the CLI polls + downloads in one step. `--timeout <ms>` controls the cap (default 15 min for video, 30 min for upscale and batches).

**2. Fire-and-forget, resume later.** Start the job, capture the request id, walk away, then resume:

```bash
# start (returns immediately)
JOB=$(quickdesign video generate --provider seedance \
  --image https://cdn/foo.jpg --prompt "..." | jq -r '.request_id')
echo $JOB > /tmp/myjob.id

# minutes later — same machine, another terminal, or even a cron tick
quickdesign video wait seedance "$JOB" --timeout 1800000 -o ./out.mp4
```

`wait` re-polls the BFF, downloads when ready, and prints the same JSON shape as `--wait` would have.

**3. Background it.** `nohup quickdesign video generate ... --wait -o ./out.mp4 > job.log 2>&1 &` then `tail -f job.log`.

For Advantage+ batches use `ad-creator batch-wait <batchId> -o ./ads` — same idea but downloads every completed concept to the directory.

The job state itself lives in the BFF (`ugc_video_jobs` / `image_generation_jobs` tables) so you can leave a job for hours and pick it up later. Result URLs (R2) don't expire.

## Claude Code skill

The npm package bundles a complete Claude Code skill (`SKILL.md` + per-domain reference docs covering image / video / Spy Brands / Brand DNA / UGC pipelines). The recommended way to install it is `quickdesign init` (see [Install](#install)) — it copies the bundle into `~/.claude/skills/quickdesign/` and Claude Code picks it up on the next session.

If you want to inspect or copy it manually instead, the bundled source lives at:

```
$(npm root -g)/@quickdesign/cli/skills/quickdesign/
```

Once installed, asking Claude Code things like *"generate a UGC ad for this product page"* or *"analyze Kizik's recent ads"* will route through the skill, which calls `quickdesign …` on your behalf.

## Development

```bash
git clone https://github.com/ottasilver/quickdesign-cli
cd quickdesign-cli
npm install
npm run build
npm link                           # makes `quickdesign` available on PATH

# point at a local BFF
export QUICKDESIGN_BASE_URL=http://localhost:3001
export QUICKDESIGN_TOKEN="<your local supabase jwt>"

quickdesign whoami
quickdesign spy brands --search anything --limit 3 --human
```

## Releasing

Publishes are automated via GitHub Actions (`.github/workflows/publish.yml`). A tag push to `main` triggers `npm publish`.

One-time repo setup (maintainers):

1. Create a [granular access token](https://www.npmjs.com/settings/~/tokens) on npm — scope `@quickdesign`, read+write, bypass-2FA.
2. Add it to the repo as a GitHub secret named `NPM_TOKEN` (Settings → Secrets and variables → Actions).

Cut a release:

```bash
# bump + tag + commit
npm version patch        # or: minor / major
git push --follow-tags   # CI takes over, runs build + publish

# dry-run via Actions UI:
gh workflow run publish.yml -f dry_run=true
```

The workflow also verifies the git tag matches `package.json#version` before publishing, so `v0.1.2` tag + `package.json: 0.1.1` will fail loudly rather than mis-tag the release.

## Roadmap

- **v0.1** ✅ — Auth (browser OAuth + token fallbacks), `spy`, `image`, Claude Code skill
- **v0.2** ✅ — `video` (Sora 2 / Kling / Seedance 2.0 incl. r2v / UGC + upscale), `brand`
  (scraper + SSE DNA), `ad-creator` (single + advantage+), `design` (list / get / delete /
  download — PostgREST-direct)
- **v0.3** ✅ — `init` bootstrap (doctor + bundled skill + login), `video subtitle` (auto-subtitle / karaoke), refresh-token handling, browser-OAuth Chrome PNA fix + parallel terminal-paste fallback
- **v0.4** — local-file sources (`--image ./foo.jpg`) via auto-upload to R2
- **v1.0** — plugins, opt-in telemetry, Homebrew tap

## License

MIT

© QuickDesign · MIT · anthropics/claude-plugins-community

Похожие плагины

Все плагины по теме «ИИ и ML» →
claude-imagine Claude Imagine Плагин claude-imagine для Claude Code генерирует и редактирует изображения и видео без перехода в другие сервисы. ★ 3 785звёзд репо muapi-ugc-video-factory SamurAIGPT Скилл muapi-ugc-video-factory генерирует вертикальные 9:16 UGC-видеоролики с озвучкой по фото человека, фото товара и тексту реплики. Помогает собирать рекламные креативы для соцсетей через команды агента. CX Codex +1 2 600установок openFlow molkex MCP-сервер openFlow подключает агента к Google Flow для генерации изображений Nano Banana и видео Veo через ваш Google-аккаунт. CX Codex +1 ★ 10звёзд репо muapi-ugc-ads-workflow SamurAIGPT Скилл muapi-ugc-ads-workflow для Claude Code, Codex, Cursor и других платформ собирает UGC-рекламу продукта: совмещает селфи и фото товара, пишет сценарий и генерирует вертикальное видео для TikTok. CX Codex +1 667установок seedance-2.0-prompter pexoai Скилл seedance-2.0-prompter для Claude Code собирает из изображений, видео, аудио и описания структурированный JSON-промпт для Seedance 2.0. Создаёт промпты для сложных запросов на генерацию видео. CX Codex +1 1 400установок scenario-seedance-storyboard scenario-labs Скилл scenario-seedance-storyboard готовит раскадровки и цепочки поз для видеомоделей Seedance 2.0 и 2.5. Он устраняет сброс движения и телепортацию конечностей между кадрами в танцах, драках или спорте. CX Codex +1 870установок

Из того же набора37

Весь набор →
tres-rollup-rules Скилл tres-rollup-rules находит повторяющиеся проводки в TRES Finance и предлагает правила агрегации в суточные или месячные записи для выгрузки в ERP. CX Codex +1 ★ 4 931звёзд репо tres-erp-rule-suggestions Скилл tres-erp-rule-suggestions помогает создавать и проверять ERP-правила для криптоорганизаций в Tres Finance, связывая типы транзакций со счетами. CX Codex +1 ★ 4 931звёзд репо tres-cost-basis Скилл tres-cost-basis ведёт расчёт себестоимости криптоактивов в TRES Finance: статус, смена стратегии FIFO или LIFO, пересчёт и список найденных проблем. CX Codex +1 ★ 4 931звёзд репо html-plan Плагин html-plan собирает план разработки в интерактивную HTML-страницу с деревом решений, макетами и схемами. Помогает согласовать архитектуру до написания кода. ★ 4 931звёзд репо next-steps Плагин next-steps для Claude Code предлагает до трёх вариантов следующего запроса после каждого ответа. Выбранный вариант попадает в поле ввода как черновик, который можно изменить. ★ 4 931звёзд репо eli5 Команда /eli5 <тема> собирает HTML-страницу с крупными картинками и минимумом слов — для объяснения темы с нуля. ★ 4 931звёзд репо tres-finance-plugin Плагин связывает Claude Code с сервисом TRES Finance для бухгалтерского учёта криптовалют и сверки балансов с DeBank. ★ 4 931звёзд репо testdino Подключает TestDino к Claude Code через удалённый MCP-сервер: анализируйте прогоны, разбирайте сбои и управляйте ручными тестами. ★ 4 931звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой