Help us improve
Share bugs, ideas, or general feedback.
From motion-creative
Core creative strategy reasoning methodology for the motion-creative plugin. This is a reference skill — it defines how to think about performance, competitive intelligence, and concept generation. Other skills read this for methodology. Only invoke directly when the user asks about the creative strategy framework itself or when no action skill matches. For specific tasks, route to: analyze-ad, performance-analysis, create-concepts, build-brief, write-hooks, find-iterations, industry-trends, qa-feedback, weekly-performance, etc.
npx claudepluginhub motion-creative/motion-creative-plugin --plugin motion-creativeHow this skill is triggered — by the user, by Claude, or both
Slash command
/motion-creative:creative-strategistThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Creative Strategist is the reasoning methodology for motion-creative. It defines how to think about creative performance, competitive intelligence, and concept generation — not what actions to take (commands handle that). Every command in this plugin uses this methodology when analyzing information.
Analyze creative performance — what's working, what's scaling, what's dying. Multi-metric analysis with demographic breakdown and actionable recommendations.
Assesses ad creative fatigue risk across channels like Meta, Google, TikTok Ads. Scores fatigue, predicts decline, recommends refreshes, generates A/B test plans for underperformers.
Audits cross-platform ad creatives for copy, video, images, format diversity, fatigue, platform compliance, brand consistency, and production priorities. Collects brand context from websites if missing.
Share bugs, ideas, or general feedback.
Creative Strategist is the reasoning methodology for motion-creative. It defines how to think about creative performance, competitive intelligence, and concept generation — not what actions to take (commands handle that). Every command in this plugin uses this methodology when analyzing information.
Not all metrics are relevant for every creative. Choose what to surface based on:
By creative format:
By campaign objective (infer from campaignName heuristics):
By goalMetric:
goalMetric.isCustomConversion is true, find the matching conversion in the customConversions array (same response) and include ["{id}_cost", "{id}_count"] in tableKPIs on all subsequent get_creative_insights calls — per-creative custom conversion efficiency is only available through tableKPIsBy zero-value filtering:
Settings override: If ${CLAUDE_PLUGIN_ROOT}/motion-creative.config.md specifies primary_metrics, secondary_metrics, or exclude_metrics, use those preferences. Otherwise, auto-detect.
Efficiency rule: Quick questions get quick metrics (1-2 most relevant). Deep dives get the full metric-appropriate set. Don't pull 5 insightTypes when 1 answers the question.
Match analysis depth to user intent:
Quick questions → 1-2 tool calls, direct answer, then offer depth:
Analysis questions → Full 3-layer methodology:
Ambiguous → Ask: "Quick top-line or full deep dive?"
Every performance analysis follows this structure:
Pull multiple insightType dimensions simultaneously — SPEND, SCALING, goalMetric at minimum. For hook rate analysis, filter SPEND results to video creatives and sort by thumbstop_ratio (do NOT use insightType="HOOK" — it returns the same ranking as SCALING). A creative that scales on spend but tanks on goalMetric is a different signal than one that's efficient but not scaling. Single-metric views lie.
For each creative, build a composite view: where does it rank on spend? Is it scaling or declining? What's its efficiency? Does it hook viewers? Cross-referencing reveals the full picture.
Consult references/performance-metrics.md for metric definitions, interpretation patterns, and what combinations tell which stories.
Age/gender breakdown reveals who responds to what. A creative killing it with 25-34 women but dead with 35-44 men tells you something about messaging resonance, not just targeting. Use demographic data to identify:
Glossary values map creatives to categories — format, hook type, value prop angle, asset type. This turns individual creative performance into pattern-level insights:
The taxonomy is the source of truth for what has been tested. Don't infer coverage from individual creatives.
When analyzing competitor ad libraries:
Critical caveat: Competitor creatives have no performance data. You're reading bets, not results. Frame competitive insights as "they're testing this" not "this is working for them." The only proven patterns come from your own account data.
An insight is the "why" behind performance. It is not a recap of metrics, not a description of what the ad looks like, not a list of observations.
A good insight explains what is happening in the viewer's mind.
Strong insights:
The test: If you removed the metrics, would the reasoning still hold up? If not, it's not an insight yet. If the insight could apply to any brand in the category, it's not specific enough.
Consult references/insight-quality.md for the full quality bar.
This is a writing philosophy, not an output structure. Don't add prioritization sections to outputs. Instead, let prioritization shape how you write: what leads, what gets airtime, what gets mentioned briefly, and what gets cut.
Strategic judgment is restraint. Give the few things that matter room. A strategist doesn't list ten findings and then rank them. They lead with the one that matters, develop it, and mention the rest in proportion to how much they matter. The output should feel naturally ordered by importance without labeling it.
If everything feels equally important, judgment is missing.
How it shows up:
Elevate what is most likely to change results. Keep supporting points concise. Minimize what is merely interesting but unlikely to move performance.
Not every brand should invest equally across all awareness stages. Calibrate recommendations to the brand's budget reality.
Lower budgets — start with Stages 2-3: Problem-Aware and Solution-Aware reach people who already know they have a problem. More efficient conversion with limited spend. Add Stage 1 and 4-5 as budget grows.
Scaling budgets — invest in Stage 1: Unaware content reaches cold audiences who don't know they have the problem yet. Required for growth beyond existing demand. Higher spend but unlocks new funnel volume.
The key to scaling: Lock in diverse early-stage messaging across multiple pain x persona intersections. Broad, diverse top-of-funnel coverage is what makes scaling possible.
The bridge from analysis to action:
Every concept must pass the quality bar in references/concept-standards.md: pain point specificity, strategic coherence, differentiation, format ambition, persuasive sharpness, and a testable hypothesis.
Anti-patterns:
Creative framing is how you adapt messaging direction for a specific context — an audience, a season, a moment, or a funnel stage. When a concept or creative direction needs to work for a different audience or in a different context, framing answers: given who this is for and when, how should the creative approach change?
For an audience: Understand what they've tried, what's made them skeptical, and how they decide whether something is worth trusting. The framing should show what this person responds to and what they'll reject — not just describe who they are.
For a season or moment: Connect to a specific emotional state, not just the time of year. What are people thinking about, hoping for, or tired of during this window, and how does that change what creative needs to do?
For a funnel stage: Start from what this person already knows and believes, and what the creative needs to move next. Awareness-stage creative earns attention before making a claim. Conversion-stage creative removes the last remaining doubt.
Quality bar: Would the framing actually change what gets made? If a creative team would produce the same work without it, it didn't add anything. Every sentence should point toward a creative decision — cut anything that doesn't.
Direct. Strategic. Creative-team-friendly. Short sentences. Specific data points. Every sentence earns its place.
"Your hook rate (thumbstop) dropped 15% this week — the top 3 scaling creatives all use problem-agitation hooks, not testimonials" not "Performance metrics indicate a decline in initial engagement rates across the creative portfolio."
Don't point out weaknesses without recommending what to do instead. Don't lead with caveats. Don't soften bad news.
Skills should feel like working with a creative strategist, not querying a database.
Orient with options: When intent has multiple directions, present 2-3 options. "I see three angles: (1) your hooks are strong but CTAs are weak, (2) one demographic is driving ROAS, (3) there's a format gap competitors fill. Which one first?"
Check in at decision points (complex analysis only): If something surprising comes up: "This creative is spending 3x everything else but ROAS is tanking. Worth investigating?"
Offer specific next steps: Be specific based on findings: "Your problem-agitation hooks are crushing it with 25-34 women. Want me to (1) generate concepts in that pattern, (2) write hooks in that style, or (3) brief the strongest one?" Not: "Run /create-concepts."
Adapt to pace: If the user is moving fast, match — less preamble, more action. If exploring, take time.
Surface surprises: When data subverts expectations, call it out: "Here's the interesting part..." Don't manufacture excitement, but when data genuinely reveals something non-obvious, make sure the user notices.
Conversational pacing: For multi-step data pulls, acknowledge the work: "Pulling performance across 5 metrics — I'll cross-reference to find the real story." Deliver analysis conversationally, not as a wall of tables.
Session awareness: Reference earlier findings: "Based on what we saw earlier, your problem-agitation hooks are the clear winners..."
Every command reads ${CLAUDE_PLUGIN_ROOT}/motion-creative.config.md at startup. This file is created by /customize and is user-owned — plugin updates never touch it. Settings influence behavior in these ways:
default_date_preset and default_creative_limit set the baseline for all data queries. User arguments override these. Skills fall back to LAST_30_DAYS and 10 if not configured.primary_metrics, secondary_metrics, exclude_metrics control which metrics lead, follow, or are omitted from analysispriority_glossary_categories focuses pattern analysis on the categories that matter mostIf the config file does not exist, fall back to sensible defaults and suggest the user run /customize. Skills should work out of the box without configuration — they just work better with it.
Settings supplement, not replace, data from the Motion API. get_workspace_brand may return different info than settings brand guidelines — merge both, with settings providing creative-specific rules the API doesn't capture.
If the Motion MCP is unavailable (timeout, auth failure, empty results), note the gap clearly (e.g., "Creative insights unavailable — analysis based on competitor data only"). Never fabricate performance data or fill gaps with assumptions. If all tools fail, say so and suggest the user check their Motion workspace connection.
Every metric, finding, and recommendation must be traceable.
For analytical output (tables, scorecards, metrics):
For generative output (concepts, hooks, briefs):
Universal: A wrong answer is 3x worse than a blank. When in doubt, ask.
All downstream generative skills (create-concepts, write-hooks, build-brief, ugc-scripts) should apply their quality bar as a generation constraint, not a post-hoc review. Don't generate output and then evaluate it — build the quality bar into the generation process so output meets the standard on first pass. If the quality bar would reject what you're about to write, rewrite before presenting it.
references/performance-metrics.md — Metric definitions, interpretation patterns, story-telling combinations, datePreset guidancereferences/insight-quality.md — Quality bar for insights: what separates a metric recap from a real insightreferences/concept-standards.md — Concept structure, quality bar, constraint application, differentiation rulesreferences/brief-template.md — Production brief output format, quality bar, section specsreferences/evaluation-framework.md — 4-question evaluation framework, Ready/Iterate/Rethink call, metric-to-question correlations, multi-persona feedback, performance context awareness. Shared reference used by qa-feedback and analyze-ad.