canva-sdks/canva-brand-check

Brand Checker

Compare a design against the user's brand kit and report, point by point, where it follows the brand and where it drifts. This is a specialised, brand-aware version of canva-design-feedback: same read-only "read the design, then critique" core, but the rubric is the brand kit. It never edits the design.

The brand-kit data gap — read this first

Canva:list-brand-kits is documented to return brand kit IDs, names, and thumbnails. It may NOT return the machine-readable palette (hex values) and font families. Your approach depends on what you actually get back:

• If the kit exposes colors/fonts → use those exact hex codes and font names as the rubric (precise check).
• If it only exposes a thumbnail/name → you cannot do an exact hex/font match. Fall back to a visual comparison against the kit thumbnail, and ASK the user to paste their brand colors (hex) and fonts so you can check precisely. Be explicit that, without those, the color/font findings are approximate.

Never invent brand colors or fonts. If you don't have the real values, say so.

Reading the design's actual colors and fonts

Canva:get-design-content returns text only — not colors or fonts.

• A read-only editing transaction (Canva:start-editing-transaction → inspect → Canva:cancel-editing-transaction, always cancel) reliably gives element text, positions, and sizes.
• Colors and fonts are NOT reliably exposed by the transaction — tested: it often returns only text + position + dimension, with no color/font attributes. So the thumbnail is your primary evidence for color and typography. Use any style data the payload happens to include, but never assert a design's hex or font as fact unless it was actually in the payload.

Because both the brand kit (see the gap above) AND the design itself frequently lack machine-readable colors/fonts, brand-check is often a visual comparison (design thumbnail vs. brand-kit thumbnail) plus the user-supplied palette/fonts. Use Canva:get-design-thumbnail for logo placement and overall visual tone.

Workflow

Step 1: Resolve the design

Short link → Canva:resolve-shortlink; full URL → extract ID; raw D... ID → use directly; otherwise ask.

Step 2: Get the brand kit

• Canva:list-brand-kits. If several, ask which one (or infer from team/context).
• Capture whatever the kit exposes (name, thumbnail, and colors/fonts if present).
• Apply the data-gap handling above. If scopes are missing (e.g. "Missing scopes: [brandkit:read]"), tell the user to disconnect and reconnect the Canva connector to refresh the token.

Step 3: Read the design

• Canva:get-design-thumbnail for visual/logo/tone.
• Read-only transaction (start → inspect → cancel) for the actual colors and fonts in use.

Step 4: Compare against the brand

Check each dimension and mark On brand / Off brand / Can't verify:

• Color — are fills/text/accents within the brand palette? Flag off-palette hexes (and the nearest brand color).
• Typography — do fonts match brand fonts? Flag non-brand families and inconsistent sizing/weight usage.
• Logo — present where expected, correct version, not stretched/recolored/crowded (visual check from thumbnail).
• Tone & copy — does the wording match the brand voice the user describes?
• Consistency — is brand application consistent across all pages?

Use Can't verify honestly whenever the kit didn't expose the data and the user hasn't supplied it.

Step 5: Report

## Brand check — "<design title>" vs "<brand kit name>"

Overall: ⚠️ Mostly on brand, 3 issues

### Off brand
- [Color] Page 2 heading is #1A73E8 — not in palette. Nearest brand color: #0B5CD7.
- [Font] Page 4 body uses Arial; brand body font is Inter.

### Can't verify (need input)
- Brand kit didn't expose hex values. Paste your palette + fonts for an exact check,
  or confirm the colors above against your guidelines.

### On brand
- Logo placement and cover treatment match the kit.

Step 6: Offer to fix

Offer to correct the API-fixable issues via canva-edit-design — note that the API can change text color and font size/weight/style, but CANNOT change font family or background colors (those are manual in Canva; see canva-edit-design).

Rules

• Read-only: always cancel-editing-transaction after inspecting. Never commit.
• Never fabricate brand values — use the kit's real data or what the user provides, otherwise mark Can't verify.
• Always name the specific page/element and the offending value vs. the brand value.
• Distinguish hard violations (wrong logo, off-palette color) from soft ones (slightly inconsistent spacing).

Usage telemetry

When calling any Canva: tool, prefix the user_intent argument with the tag [skill:canva-brand-check] followed by a space and the normal concise description of what the user is trying to accomplish (e.g. [skill:canva-brand-check] Check against the brand kit). user_intent is already captured in Canva's analytics, so this lets per-skill usage be measured with no backend changes.