/canva-manager

name: canva-manager
description: |
  Comprehensive Canva API integration skill for managing designs, folders, assets, and exports.
  Uses a 3-mode workflow: PLAN (analyze what needs to be done), CLARIFY (ask user questions),
  and IMPLEMENT (execute changes via Python scripts). Ensures safe operations by always
  confirming changes before execution. Use this skill when the user wants to work with their
  Canva account, manage designs, organize folders, upload assets, or export designs.

Canva Manager Skill

> **QUICK REFERENCE** > - **Scripts location**: `scripts/` (NOT `skills/*/scripts/` - those paths don't exist) > - **Auth check**: `.venv\Scripts\python.exe scripts/auth_check.py` > - **List designs**: `.venv\Scripts\python.exe scripts/list_designs.py` > - **List folders**: `.venv\Scripts\python.exe scripts/list_folders.py` > - **Export design**: `.venv\Scripts\python.exe scripts/export_design.py --id "ID" --format pdf` > - **API client**: `scripts/canva_client.py` (import: `from canva_client import get_client`) > - **Sample script**: `scripts/samples/sample_canva_operations.py` > - **Always use**: `.venv\Scripts\python.exe` (Windows) or `.venv/bin/python` (Mac/Linux) > > **WARNING**: Commands below referencing `skills/canva-*/scripts/*.py` are WRONG paths. > Use actual scripts in `scripts/` folder. For custom operations, see `scripts/samples/sample_canva_operations.py`.

A comprehensive skill for managing Canva designs, folders, and assets through the Canva Connect API. This skill operates in a **3-mode workflow** to ensure safe and accurate operations on your Canva account.

Overview

This skill provides full control over your Canva account including:

• **Designs**: List, view, create, export, and manage designs (Instagram posts, Presentations, Documents, etc.)
• **Folders**: Create, organize, move items, and manage your project structure
• **Assets**: Upload images, videos, and other media to your Canva library
• **Exports**: Export designs to various formats (PDF, PNG, JPG, PPTX, MP4, GIF)

3-Mode Workflow

**CRITICAL: Always follow this workflow. Never skip to implementation without completing Plan and Clarify modes.**

Mode 1: PLAN

Before making ANY changes to Canva, you MUST:

1. **Analyze the Request**

• What exactly does the user want to accomplish?
• Which Canva resources are involved (designs, folders, assets)?
• What API operations will be needed?

2. **Gather Current State**

• Run the discovery scripts to understand current Canva account state
• List relevant designs, folders, or assets
• Identify exactly which items will be affected

3. **Create Detailed Plan**

• Document every action that will be taken
• List which designs/folders/assets will be modified
• Specify the exact changes (names, exports, moves, etc.)
• Identify potential risks or irreversible actions

4. **Present Plan to User** Format the plan clearly:

   ## Canva Operation Plan

   ### Objective
   [What we're trying to accomplish]

   ### Current State
   - Found X designs in folder Y
   - Design "ABC" has 5 pages
   - etc.

   ### Proposed Actions
   1. [Action 1 - specific details]
   2. [Action 2 - specific details]

   ### Potential Risks
   - [Any irreversible actions]
   - [Rate limit considerations]

   ### What Will NOT Be Changed
   - [Explicitly list unaffected items]

Mode 2: CLARIFY

After presenting the plan, you MUST ask clarifying questions:

1. **Required Questions**

• "Does this plan accurately reflect what you want to do?"
• "Are there any items I should exclude from this operation?"
• "Should I proceed with all X items or just specific ones?"

2. **Context-Specific Questions**

• For exports: "What format and quality do you prefer?"
• For folder operations: "Should I create backups first?"
• For design modifications: "Should I work on copies instead of originals?"
• For bulk operations: "Do you want me to process all at once or in batches?"

3. **Confirmation Requirements**

• Get explicit "yes" or confirmation before proceeding
• If user has concerns, return to PLAN mode with modifications
• Never assume silence means approval

Mode 3: IMPLEMENT

Only after explicit user approval:

1. **Pre-Implementation Checks**

• Verify credentials are valid (run auth check script)
• Confirm API rate limits are sufficient
• Double-check target items match the plan

2. **Execute with Logging**

• Run the appropriate Python scripts
• Log every API call and response
• Save results to the output folder

3. **Report Results**

• Show exactly what was changed
• Provide links/IDs of affected items
• Note any errors or partial completions

Environment Setup

Before using this skill, ensure the `.env` file is configured:

# Required - Get from https://www.canva.com/developers/
CANVA_CLIENT_ID=your_client_id
CANVA_CLIENT_SECRET=your_client_secret

# OAuth tokens (obtained after authorization)
CANVA_ACCESS_TOKEN=your_access_token
CANVA_REFRESH_TOKEN=your_refresh_token

# Optional
CANVA_REDIRECT_URI=http://127.0.0.1:3001/oauth/redirect

Running Python Scripts (Virtual Environment)

**IMPORTANT**: Always use the virtual environment Python:

# Windows
.venv\Scripts\python.exe scripts/script_name.py

# macOS/Linux
.venv/bin/python scripts/script_name.py

Available Scripts

All scripts are in `scripts/`:

Discovery Scripts (Safe - Read Only)

• `auth_check.py` - Verify credentials and get user info
• `list_designs.py` - List all designs with metadata
• `list_folders.py` - List folder structure
• `get_design_details.py` - Get detailed info about a specific design
• `list_folder_contents.py` - List items in a specific folder

Action Scripts (Require Confirmation)

• `export_design.py` - Export a design to specified format
• `create_folder.py` - Create a new folder
• `move_items.py` - Move items between folders
• `upload_asset.py` - Upload an image/video