canva-image-editor

name	canva-image-editor
description	Edit and modify image-based designs in Canva (social media posts, posters, flyers, etc.). Use this skill when user wants to modify existing image designs or create new ones. Follows 3-mode workflow: PLAN changes, CLARIFY with user, then IMPLEMENT. For presentations use canva-presentation skill. For videos use canva-video skill.
allowed-tools	["Bash","Read","Write","Edit","AskUserQuestion"]

Canva Image Editor Skill

QUICK REFERENCE

• Scripts location: scripts/ (NOT skills/canva-image-editor/scripts/ - those don't exist)
• Auth check: .venv\Scripts\python.exe scripts/auth_check.py
• List designs: .venv\Scripts\python.exe scripts/list_designs.py
• API client: scripts/canva_client.py (import: from canva_client import get_client)
• Sample script: scripts/samples/sample_canva_operations.py

WARNING: Commands below referencing skills/canva-*/scripts/*.py are WRONG paths. Write custom Python using canva_client.py. See scripts/samples/sample_canva_operations.py.

Edit and modify image-based designs in Canva including social media posts, posters, flyers, logos, and other static graphics.

Scope of This Skill

This skill handles:

• Instagram Posts/Stories
• Facebook Posts/Covers
• Twitter/X Posts
• LinkedIn Posts/Banners
• Posters & Flyers
• Logos
• Business Cards
• Invitations
• Infographics
• Thumbnails
• Any static image design

NOT handled by this skill:

• Presentations/Slideshows → Use canva-presentation
• Videos/Animations → Use canva-video
• Document editing → Use canva-document
• Bulk exports → Use canva-export

3-Mode Workflow

MODE 1: PLAN

Before any edits, analyze and document:

1. Identify the Target Design

   # Use canva-explorer first to find the design
   python skills/canva-explorer/scripts/get_design.py --id "DESIGN_ID" --include-pages
   

2. Analyze Current State

   • Design dimensions
   • Number of elements (text, images, shapes)
   • Current colors and fonts
   • Background type

3. Document Proposed Changes

   ## Edit Plan for "[Design Name]"
   
   ### Current State
   - Type: Instagram Post (1080x1080)
   - Elements: 3 text layers, 2 images, 1 background
   - Primary colors: #FF5733, #FFFFFF
   
   ### Proposed Changes
   1. Update headline text from "X" to "Y"
   2. Replace main image with new uploaded asset
   3. Change background color to #2E86AB
   
   ### Elements NOT Being Changed
   - Logo placement (top-right)
   - Footer text
   - Secondary image
   
   ### Risks
   - Text may overflow if new headline is longer
   - New image aspect ratio may need adjustment
   

MODE 2: CLARIFY

Ask user to confirm:

1. Verify Changes

   • "The headline will change from 'Summer Sale' to 'Winter Sale'. Correct?"
   • "Should I resize the new image to fit, or crop it?"

2. Offer Options

   • "Should I work on the original or create a copy first?"
   • "Do you want to preview the changes before finalizing?"

3. Handle Ambiguity

   • "I found 3 text elements. Which one should I modify?"
   • "The new color doesn't meet contrast guidelines. Proceed anyway?"

MODE 3: IMPLEMENT

Execute approved changes:

# Example: Update text element
python skills/canva-image-editor/scripts/update_text.py \
  --design "DESIGN_ID" \
  --element "ELEMENT_ID" \
  --text "New headline text"

# Example: Replace image
python skills/canva-image-editor/scripts/replace_image.py \
  --design "DESIGN_ID" \
  --element "ELEMENT_ID" \
  --new-image "path/to/image.jpg"

# Example: Update colors
python skills/canva-image-editor/scripts/update_colors.py \
  --design "DESIGN_ID" \
  --primary "#2E86AB" \
  --secondary "#F4D35E"

Available Scripts

Analysis Scripts

• analyze_design.py - Deep analysis of design elements
• extract_colors.py - Get color palette from design
• extract_text.py - Get all text content
• check_dimensions.py - Verify size and aspect ratio

Edit Scripts

• update_text.py - Modify text content
• replace_image.py - Swap images in design
• update_colors.py - Change color scheme
• resize_design.py - Change dimensions
• duplicate_design.py - Create a copy before editing

Creation Scripts

• create_from_template.py - New design from Canva template
• create_blank.py - New blank design with dimensions

Design Types and Dimensions

Type	Dimensions	Aspect Ratio
Instagram Post	1080x1080	1:1
Instagram Story	1080x1920	9:16
Facebook Post	1200x630	1.91:1
Facebook Cover	820x312	2.63:1
Twitter Post	1600x900	16:9
LinkedIn Post	1200x1200	1:1
LinkedIn Banner	1584x396	4:1
Pinterest Pin	1000x1500	2:3
YouTube Thumbnail	1280x720	16:9
Poster	18x24 inches	3:4
A4 Document	210x297mm	1:1.41

Element Types

When working with design elements:

• Text Elements: Headlines, body text, captions
• Image Elements: Photos, graphics, icons
• Shape Elements: Rectangles, circles, lines
• Frame Elements: Image frames, masks
• Background: Solid color, gradient, image

Safety Guidelines

1. Always duplicate first for major changes
2. Check text overflow when changing content
3. Verify image quality after replacement
4. Test color contrast for accessibility
5. Log all changes to output folder

Example Interactions

"Change the headline in my Instagram post"

[PLAN]
- Found design "Summer Promo" (1080x1080)
- Contains headline: "SUMMER SALE 50% OFF"
- Proposed: Change to user's new text

[CLARIFY]
- What should the new headline say?
- Keep same font and size?

[IMPLEMENT]
- Update text element with new content
- Verify no overflow
- Confirm change complete

"Update the colors to match my brand"

[PLAN]
- Analyze current colors: #FF5733, #FFFFFF, #333333
- User's brand colors: #2E86AB, #F4D35E, #1A1A1A
- Map old → new colors

[CLARIFY]
- Confirm color mapping is correct
- Should background also change?
- Keep or update any accent colors?

[IMPLEMENT]
- Apply color changes to all elements
- Verify readability
- Export preview

Output Files

Changes are logged to:

• output/edits/ - Before/after comparisons
• output/logs/edit_history.json - All modifications
• output/previews/ - Preview exports