# QuickDesign Plugin for AI Media Generation: Architecture, Features, and CLI Reference > Explore the QuickDesign plugin architecture and features for AI media generation. This Claude-Code skill simplifies image, video, and ad asset creation without API key management. - Repository: [Anthropic/claude-plugins-community](https://github.com/anthropics/claude-plugins-community) - Tags: api-reference - Published: 2026-08-29 --- **The QuickDesign plugin is a Claude-Code skill and CLI wrapper that enables Claude agents to drive the full QuickDesign media-generation stack—handling images, videos, ads, and brand assets—without manually managing API keys, polling, or storage.** The QuickDesign plugin for AI media generation provides a comprehensive interface between Claude agents and the QuickDesign media stack. Located in the `anthropics/claude-plugins-community` repository, this tool eliminates manual API handling by wrapping complex generation workflows into declarative CLI commands and structured skill definitions. ## Architecture Overview The plugin consists of three tightly-coupled components that bridge user intent to media generation: - **CLI binary (`quickdesign`)**: Published on npm as `@quickdesign/cli`, this binary provides command-line access to image generation, video generation, ad-creator, Spy Brands, Brand DNA, and Meta publishing services. - **Claude-Code skill bundle**: Located at `quickdesign/skills/quickdesign/`, this includes [`SKILL.md`](https://github.com/anthropics/claude-plugins-community/blob/main/SKILL.md) and model cards that Claude loads from `~/.claude/skills/quickdesign/`. The skill defines cardinal rules, decision trees, and execution pipelines. - **Plugin manifest ([`plugin.json`](https://github.com/anthropics/claude-plugins-community/blob/main/plugin.json))**: Found at [`quickdesign/.claude-plugin/plugin.json`](https://github.com/anthropics/claude-plugins-community/blob/main/quickdesign/.claude-plugin/plugin.json), this describes the plugin to the Claude marketplace and points to the bundled skill files. ## Core Functionalities ### AI-Generated Media (Images & Videos) The plugin supports multiple generation models through unified CLI commands. According to [`quickdesign/skills/quickdesign/models/seedance-2.0-r2v.md`](https://github.com/anthropics/claude-plugins-community/blob/main/quickdesign/skills/quickdesign/models/seedance-2.0-r2v.md), **Seedance 2.0 R2V** is the universal default for UGC, talking-avatar, and multi-segment promos. Additional supported models include **Kling 3-Pro**, **Sora 2**, **Nano-Banana 2**, and **GPT Image**. The skill enforces *reference-grammar* using labels like `@Image1` and `@Audio1` to prevent visual anchors from being overwritten by prose instructions. ### Smart Ad Creator Provides one-shot ad generation via `quickdesign ad-creator` and the **Advantage+** fan-out feature that generates 16 concept ads in parallel for rapid creative testing and iteration. ### Spy Brands Library Competitor intelligence functionality defined in [`quickdesign/skills/quickdesign/references/spybrands-add-on-miss.md`](https://github.com/anthropics/claude-plugins-community/blob/main/quickdesign/skills/quickdesign/references/spybrands-add-on-miss.md). This enables searching competitor ad libraries, listing brand-specific ads, fetching cross-brand winners, and handling empty-result fall-backs gracefully. ### Brand DNA Extraction Scrapes website visual assets (colors, fonts, logos) or runs full Claude-streamed brand-DNA pipelines that yield JSON or NDJSON events for maintaining brand consistency across generated content. ### Design Management Direct integration with the QuickDesign PostgREST backend via `quickdesign design` commands. Supports listing, fetching, downloading, and archiving saved creatives without leaving the terminal. ### Meta-Ready Publishing Deploys designs as **PAUSED** Meta advertisements to prevent accidental spend. The `quickdesign meta` namespace includes commands for publishing, querying campaigns and ad sets, retrieving insights, and generating performance reports. ### Authentication & Session Persistence The browser-OAuth flow stores tokens in `~/.config/quickdesign/auth.json` with `0600` file permissions. For CI/CD environments, the CLI accepts the `QUICKDESIGN_TOKEN` environment variable or the `--token` flag for headless authentication flows. ### Production-Ready Pipeline Safety mechanisms defined in [`quickdesign/skills/quickdesign/references/confirmation-rules.md`](https://github.com/anthropics/claude-plugins-community/blob/main/quickdesign/skills/quickdesign/references/confirmation-rules.md) include: - **Confirmation gates** requiring explicit approval before credit-spending operations - Multi-segment voice continuity via `--reference-audio` - Minimal-directive music and subtitle suppression for cleaner outputs ## Installation and CLI Usage Install the CLI globally and bootstrap the skill: ```bash npm install -g @quickdesign/cli quickdesign init ``` Generate images with reference constraints: ```bash quickdesign image generate \ --model nano-banana-2 \ --reference-image ~/avatar.jpg \ --reference-image ~/product.jpg \ -p "@Image1 holds @Image2. No music score. No subtitles or on-screen text." \ -o edited.png --wait ``` Create UGC videos with Seedance R2V: ```bash quickdesign video generate \ --provider seedance \ --reference-image ~/avatar.jpg \ --reference-image ~/product.jpg \ --duration 12 --aspect-ratio 9:16 --resolution 1080p \ -p "@Image1 in the same setting. He says: \"Check out this new shoe!\" No music score. No subtitles or on-screen text." \ -o promo.mp4 --wait ``` Batch generate Advantage+ ads: ```bash quickdesign ad-creator advantage-plus \ --product-url https://example.com/product \ -o ./ads ``` Manage designs and publish to Meta: ```bash quickdesign design list --limit 5 quickdesign design download -o ./design.jpg quickdesign meta publish \ --account 12345 \ --page 67890 \ --design \ --wait ``` ## Key Source Files The plugin's behavior is defined in these authoritative files from the `anthropics/claude-plugins-community` repository: - [`quickdesign/skills/quickdesign/SKILL.md`](https://github.com/anthropics/claude-plugins-community/blob/main/quickdesign/skills/quickdesign/SKILL.md): Main skill definition with cardinal rules and decision trees - [`quickdesign/.claude-plugin/plugin.json`](https://github.com/anthropics/claude-plugins-community/blob/main/quickdesign/.claude-plugin/plugin.json): Marketplace manifest with metadata and version info - [`quickdesign/skills/quickdesign/models/seedance-2.0-r2v.md`](https://github.com/anthropics/claude-plugins-community/blob/main/quickdesign/skills/quickdesign/models/seedance-2.0-r2v.md): Default model specifications and reference grammar rules - [`quickdesign/skills/quickdesign/references/confirmation-rules.md`](https://github.com/anthropics/claude-plugins-community/blob/main/quickdesign/skills/quickdesign/references/confirmation-rules.md): Safety mechanisms and `AskUserQuestion` patterns - [`quickdesign/skills/quickdesign/pipelines/ugc-video.md`](https://github.com/anthropics/claude-plugins-community/blob/main/quickdesign/skills/quickdesign/pipelines/ugc-video.md): Canonical multi-segment UGC workflow - [`quickdesign/skills/quickdesign/references/multi-reference-pattern.md`](https://github.com/anthropics/claude-plugins-community/blob/main/quickdesign/skills/quickdesign/references/multi-reference-pattern.md): Guidelines for `@Image` labeling in multi-reference workflows ## Summary - The QuickDesign plugin for AI media generation combines a CLI binary, Claude-Code skill bundle, and plugin manifest to automate end-to-end media workflows. - It supports multiple AI models including Seedance 2.0 R2V, Kling 3-Pro, and Nano-Banana 2 with enforced reference grammars to prevent prompt conflicts. - Features include Smart Ad Creator with Advantage+ batching, Spy Brands competitor analysis, Brand DNA extraction, and PostgREST-backed design management. - Meta publishing deploys ads in **PAUSED** status by default, while confirmation gates and OAuth session persistence ensure deterministic cost control and secure authentication. ## Frequently Asked Questions ### What models does the QuickDesign plugin support for video generation? The plugin supports Seedance 2.0 R2V as the universal default for UGC and talking-avatar content, alongside Kling 3-Pro and Sora 2. Image generation options include Nano-Banana 2 and GPT Image, all accessible via the `quickdesign video generate` and `quickdesign image generate` commands documented in the skill bundle. ### How does the plugin prevent accidental spending on AI generation? The skill enforces confirmation gates defined in [`quickdesign/skills/quickdesign/references/confirmation-rules.md`](https://github.com/anthropics/claude-plugins-community/blob/main/quickdesign/skills/quickdesign/references/confirmation-rules.md), requiring explicit user approval through `AskUserQuestion` patterns before any credit-spending operation. Additionally, Meta ads are published in **PAUSED** status by default to prevent unintended campaign spend. ### Where are authentication tokens stored when using the QuickDesign CLI? Browser-OAuth tokens are stored in `~/.config/quickdesign/auth.json` with `0600` file permissions. For CI/CD environments, the CLI accepts the `QUICKDESIGN_TOKEN` environment variable or the `--token` flag for headless authentication without interactive login. ### What is the purpose of the @Image labels in QuickDesign prompts? The `@Image` reference grammar (e.g., `@Image1`, `@Image2`) ensures that visual anchors in multi-reference workflows are never overwritten by prose instructions. This pattern is documented in [`quickdesign/skills/quickdesign/references/multi-reference-pattern.md`](https://github.com/anthropics/claude-plugins-community/blob/main/quickdesign/skills/quickdesign/references/multi-reference-pattern.md) and strictly enforced by the Claude-Code skill to maintain visual consistency across generated segments.