QuickDesign Plugin for AI Media Generation: Architecture, Features, and CLI Reference

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 and model cards that Claude loads from ~/.claude/skills/quickdesign/. The skill defines cardinal rules, decision trees, and execution pipelines.
• Plugin manifest (plugin.json): Found at 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, 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. 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 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:

npm install -g @quickdesign/cli
quickdesign init

Generate images with reference constraints:

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:

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:

quickdesign ad-creator advantage-plus \
  --product-url https://example.com/product \
  -o ./ads

Manage designs and publish to Meta:

quickdesign design list --limit 5
quickdesign design download <design-id> -o ./design.jpg
quickdesign meta publish \
  --account 12345 \
  --page 67890 \
  --design <design-id> \
  --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: Main skill definition with cardinal rules and decision trees
• quickdesign/.claude-plugin/plugin.json: Marketplace manifest with metadata and version info
• quickdesign/skills/quickdesign/models/seedance-2.0-r2v.md: Default model specifications and reference grammar rules
• quickdesign/skills/quickdesign/references/confirmation-rules.md: Safety mechanisms and AskUserQuestion patterns
• quickdesign/skills/quickdesign/pipelines/ugc-video.md: Canonical multi-segment UGC workflow
• 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, 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 and strictly enforced by the Claude-Code skill to maintain visual consistency across generated segments.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}