customize

Customize Motion Creative

Set up this plugin for your brand so every analysis, concept, and brief reflects how your team actually works.

How This Works

This command configures your motion-creative.config.md file — the source of truth that all other commands read from. This file is yours: plugin updates never touch it. You can re-run /customize anytime to update settings as your strategy evolves.

Step 1: Detect Current State

Try to read ${CLAUDE_PLUGIN_ROOT}/motion-creative.config.md.

• If the file exists: This is a re-configuration. Read it, show the user their current settings, and ask what they want to update. Only touch those sections.
• If the file does not exist: This is a first-time setup. Walk through all sections.

Step 2: Gather Context from Motion

Pull real data from the Motion workspace to pre-fill as much as possible:

Run in parallel:
1. get_auth_context → workspace ID and name
2. get_workspace_brand → brand positioning, voice
3. get_workspace_competitors → competitor list
4. get_glossary_values → available taxonomy categories

Use these results to pre-fill settings rather than asking the user for information Motion already has.

Step 3: Walk Through Configuration Sections

Work through each section, using Motion data where available and asking only when needed.

3a. Workspace & KPIs

If get_auth_context returned workspace info, apply it directly. Then ask:

Primary KPI: "What's the one metric your team optimizes for above all else?"

• Options: ROAS, CPA, CPL, CPC, Purchases, Purchase Value
• Default suggestion based on workspace type if available

Secondary KPIs: "What 2-3 metrics do you watch alongside [primary KPI]?"

• Options from: HOOK, CPA, ROAS, SPEND, SCALING, CTR_ALL, CPC, PURCHASES

3b. Competitors

If get_workspace_competitors returned results, show them: "Motion already tracks these competitors: [list]. Want to keep this list, or add/remove any?"

If no competitors configured: "Which competitor brands should we track? Use domains (e.g., competitor.com)"

3c. Brand Guidelines

If get_workspace_brand returned brand info, use it to pre-fill. Then ask the user to review and refine:

Brand Voice: "How should your ad copy sound? (e.g., casual and witty, authoritative, empathetic)"

Brand Positioning: "In one sentence, what makes your brand different?"

Creative Do's and Don'ts: "Any rules your creative team follows? Things you always or never do in ads?"

Target Audience: "Who's your primary audience? What tension does your product resolve for them?"

3d. Production Constraints

Team Size: "How big is your creative team?"

• Options: Small (1-3), Medium (4-8), Large (9+)

Production Capabilities: "What formats can your team produce?"

• Options (multi-select): UGC, Static images, Motion graphics, Full video production, Animation, Photography

Max Difficulty: "What's the most complex production your team should take on?"

• Options: Low (static, simple UGC), Medium (edited UGC, motion graphics), High (full production, multi-scene)

3e. Brief Preferences

"Do you have a custom brief template your team uses, or should we use the default?"

• If custom: Ask the user to describe their format or paste it. Save to references/custom-brief-template.md
• If default: Keep the built-in template

3f. Reporting Defaults

"What time range do you typically analyze?" (default: LAST_30_DAYS)

"How many creatives per metric is useful?" (default: 10)

3g. Metric Preferences

"Are there specific metrics you always want to see first, or any you want excluded from analysis?"

• Primary metrics: Always show these first (e.g., ROAS, CPA)
• Secondary metrics: Show when going deeper (e.g., hook rate, hold rate, CTR_ALL)
• Exclude metrics: Never show these (e.g., irrelevant conversion types)

If the user doesn't have preferences, leave these empty — skills will auto-detect based on creative format and campaign objective.

3h. Glossary Categories

If get_glossary_values returned categories, show them: "These taxonomy categories are available: [list]. Which ones matter most for pattern analysis? (or keep all)"

3i. Slack Channel (if Slack MCP available)

"Where should morning briefings be posted?" Search Slack for creative-related channels to suggest options.

Step 4: Apply Settings

Write all gathered values to ${CLAUDE_PLUGIN_ROOT}/motion-creative.config.md using this structure:

---
# motion-creative configuration
# Created by /customize. Plugin updates will not touch this file.

# ── Motion Workspace ──
workspace_id: "the-workspace-id"
workspace_name: "The Workspace Name"

# ── Primary KPI ──
primary_kpi: "ROAS"

# ── Secondary KPIs ──
secondary_kpis:
  - "hook_rate"  # Uses thumbstop_ratio from API
  - "CPA"

# ── Competitors ──
competitors:
  - "competitor1.com"
  - "competitor2.com"

# ── Reporting Defaults ──
default_date_preset: "LAST_30_DAYS"
default_creative_limit: 10
morning_briefing_lookback: "LAST_7_DAYS"

# ── Demographic Focus ──
demographic_focus: "both"
target_demographics:
  - "25-34"
  - "35-44"

# ── Production Constraints ──
team_size: "small"
production_capabilities:
  - "UGC"
  - "static"
  - "motion graphics"
max_production_difficulty: "Medium"

# ── Brief Preferences ──
brief_format: "default"

# ── Metric Preferences ──
primary_metrics: []
secondary_metrics: []
exclude_metrics: []

# ── Glossary Priority Categories ──
priority_glossary_categories: []

# ── Notification Channel ──
slack_channel: ""
---

# Brand Guidelines

## Brand Voice
[Populated from user answers and get_workspace_brand]

## Brand Positioning
[Populated from user answers and get_workspace_brand]

## Creative Do's
[Populated from user answers]

## Creative Don'ts
[Populated from user answers]

## Target Audience
[Populated from user answers]

## Current Campaign Themes
[Populated from user answers]

Replace all bracketed placeholders with real values from the user's answers and Motion API data. Every field should have an actual value — no placeholders, no empty descriptions.

Step 5: Summary

Present what was configured:

## Your Motion Creative Setup

**Workspace:** [name]
**Primary KPI:** [metric] | **Secondary:** [metrics]
**Competitors:** [list]
**Team:** [size] team with [capabilities]
**Brief format:** [default/custom]

### Brand Summary
- Voice: [summary]
- Positioning: [summary]
- Key rules: [do's/don'ts highlights]

### What's Next
Your settings are saved in `motion-creative.config.md`. Plugin updates won't touch this file.

Run these commands to start getting value:
- `/performance-analysis` — see what's working right now
- `/morning-briefing` — get tomorrow's daily delta
- `/industry-trends` — see what competitors are doing

Important Rules

• Never assume industry defaults. If Motion data doesn't provide the answer and the user hasn't said, ask.
• Skip what's already configured. On re-runs, only touch what the user asked to change.
• Use Motion data first. Don't ask the user for things the workspace already knows.
• Plain language only. Never mention "frontmatter", "YAML", or "config file internals" to the user.
• Don't rename anything. Only replace values and update content.