name: canva-design
description: |
Comprehensive design operations skill for Canva. Handles all design CRUD operations:
create, list, search, get details, get pages, check export formats. Use this skill
for any design-related operations that don't involve editing content.
For editing images use canva-image-editor, for presentations use canva-presentation.

Canva Design Operations

Complete design management: create, list, search, and inspect designs.

Capabilities

1. Create Designs - New designs with presets or custom dimensions
2. List Designs - Browse all designs with filtering
3. Search Designs - Find designs by query
4. Get Design Details - Metadata, URLs, thumbnails
5. Get Design Pages - Page thumbnails and information
6. Check Export Formats - Available export options

Available Scripts

Create Design

# By preset type
.venv\Scripts\python.exe scripts/create_design.py --type presentation --title "My Presentation"
.venv\Scripts\python.exe scripts/create_design.py --type instagram_post --title "My Post"
.venv\Scripts\python.exe scripts/create_design.py --type doc --title "My Document"

# By custom dimensions
.venv\Scripts\python.exe scripts/create_design.py --width 1080 --height 1350 --title "Instagram Portrait"
.venv\Scripts\python.exe scripts/create_design.py --width 1920 --height 1080 --title "HD Video"

# Smart create (by type name)
.venv\Scripts\python.exe scripts/smart_create_design.py instagram_post --title "My Post"
.venv\Scripts\python.exe scripts/smart_create_design.py linkedin_banner --title "Profile Banner"
.venv\Scripts\python.exe scripts/smart_create_design.py youtube_thumbnail --title "Video Thumbnail"

# List all available design types
.venv\Scripts\python.exe scripts/smart_create_design.py --list

List Designs

# List all designs
.venv\Scripts\python.exe scripts/list_designs.py

# With limit
.venv\Scripts\python.exe scripts/list_designs.py --limit 20

# Filter by ownership
.venv\Scripts\python.exe scripts/list_designs.py --ownership owned
.venv\Scripts\python.exe scripts/list_designs.py --ownership shared

# Sort options
.venv\Scripts\python.exe scripts/list_designs.py --sort modified_descending
.venv\Scripts\python.exe scripts/list_designs.py --sort title_ascending

# JSON output
.venv\Scripts\python.exe scripts/list_designs.py --json

Search Designs

# Search by query
.venv\Scripts\python.exe scripts/search_designs.py "marketing"
.venv\Scripts\python.exe scripts/search_designs.py "Q4 report"

# With filters
.venv\Scripts\python.exe scripts/search_designs.py "presentation" --ownership owned --limit 10

# Get all results with pagination
.venv\Scripts\python.exe scripts/search_designs.py "logo" --all

# JSON output
.venv\Scripts\python.exe scripts/search_designs.py "banner" --json

Get Design Details

# Get design metadata
.venv\Scripts\python.exe scripts/get_design_details.py "DAFxxxxxxxxxx"

# JSON output
.venv\Scripts\python.exe scripts/get_design_details.py "DAFxxxxxxxxxx" --json

Get Design Pages

# Get page thumbnails
.venv\Scripts\python.exe scripts/get_design_pages.py "DAFxxxxxxxxxx"

# With pagination
.venv\Scripts\python.exe scripts/get_design_pages.py "DAFxxxxxxxxxx" --offset 1 --limit 50

# Get all pages
.venv\Scripts\python.exe scripts/get_design_pages.py "DAFxxxxxxxxxx" --all

# JSON output
.venv\Scripts\python.exe scripts/get_design_pages.py "DAFxxxxxxxxxx" --json

Get Export Formats

# Check available export formats for a design
.venv\Scripts\python.exe scripts/get_export_formats.py "DAFxxxxxxxxxx"

Design Types (Presets)

Canva Built-in Presets

Smart Create Types (50+)

Use smart_create_design.py --list to see all available types including:
- All social media formats (Instagram, Facebook, LinkedIn, Twitter, YouTube, Pinterest, TikTok)
- Business documents (presentations, reports, cards)
- Marketing materials (posters, flyers, banners)
- Ad formats (leaderboard, rectangle, skyscraper)

3-Mode Workflow

MODE 1: PLAN

1. Understand what type of design is needed
2. Determine correct dimensions
3. Plan title and purpose

MODE 2: CLARIFY

Ask user to confirm:
- Design type/dimensions
- Title
- Purpose (affects which skill to use next)

MODE 3: IMPLEMENT

# Example: Create Instagram post
.venv\Scripts\python.exe scripts/smart_create_design.py instagram_post --title "Summer Sale Announcement"

# Output:
# Design Created Successfully!
# ==================================================
#   Type:        instagram_post
#   Dimensions:  1080 x 1080 px
#   Platform:    instagram
#   ID:          DAFxxxxxxxxxx
#   Title:       Summer Sale Announcement
#
#   Edit URL: https://www.canva.com/design/DAFxxxxxxxxxx/edit

Design Information Returned

Design Metadata

{
  "id": "DAFxxxxxxxxxx",
  "title": "My Design",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T12:45:00Z",
  "urls": {
    "edit_url": "https://www.canva.com/design/.../edit",
    "view_url": "https://www.canva.com/design/.../view"
  }
}

Page Information

{
  "pages": [
    {
      "id": "page_id",
      "width": 1080,
      "height": 1080,
      "thumbnail": {
        "url": "https://..."
      }
    }
  ]
}

Next Steps After Creating

1. Edit in Canva: Open the edit URL to add content
2. Use Other Skills:
3. canva-image-editor for image designs
4. canva-presentation for slide decks
5. canva-video for video content
6. Export: Use canva-export skill when done

Rate Limits

Error Handling

Design Not Found

Error: 404 Not Found - Design does not exist

Invalid Dimensions

Error: Dimensions must be positive integers

Rate Limited

Error: 429 Too Many Requests

Wait and retry.