Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ad-creative-evaluator

Score any video ad with an AI expert panel — performance marketer, creative director, and target consumer.

License: MIT Claude Skill

What This Does

Get structured, actionable feedback on any video ad creative. Three AI expert personas evaluate your ad across 8 weighted dimensions and produce a detailed report with scores, strengths, weaknesses, and specific improvement recommendations.

Quick Install

# Clone into your Claude skills directory
git clone https://github.com/Creatify-AI/ad-creative-evaluator.git ~/.claude/skills/ad-creative-evaluator

What's Inside

Feature Description
3 Expert Personas Performance Marketer, Creative Director, Target Consumer
8-Dimension Rubric Hook, Message, Visual, Audience, Pacing, CTA, Emotion, Sound-Off
Weighted Scoring Hook and CTA weighted highest (they matter most for performance)
Frame Extraction Script Python script to pull key frames from video files
Evaluation Template Structured output format with persona disagreement analysis
Improvement Workflow Links evaluation findings to specific next-step tools

Standalone Features

Expert Panel Evaluation

Every ad is reviewed from three perspectives — a performance marketer asking "will this convert?", a creative director asking "is this well-crafted?", and a target consumer asking "would I actually watch this?". When these personas disagree, it reveals the most actionable insights.

8-Dimension Rubric

Comprehensive scoring across Hook Effectiveness, Message Clarity, Visual Quality, Audience Targeting, Pacing & Structure, CTA Strength, Emotional Resonance, and Sound-Off Effectiveness. Each dimension has clear 1-10 criteria.

Frame Extraction

Python script (scripts/extract_video.py) extracts key frames from any video file — first frame (hook), evenly-spaced body frames, and last frame (CTA) — for visual analysis.

API Automation

After evaluation, automate the improvement cycle:

  • Low hook score? Generate 5 hook variants with URL-to-Video
  • Wrong avatar? Test new personas with AI Avatar API
  • Need better visuals? Use Asset Generator for higher-quality B-roll
  • Clone a better competitor ad? Use Ad Clone with your product

🔑 Getting Your API Key

Getting set up takes less than 2 minutes:

  1. Create a free account at creatify.ai
  2. Head to Settings → API
  3. Copy your API ID and API Key
  4. You're ready to go — the other skills in this series include full code examples

New accounts include free credits so you can try everything out before committing.

File Structure

ad-creative-evaluator/
├── SKILL.md                         # Main skill (install this)
├── scripts/
│   └── extract_video.py             # Frame extraction utility
├── references/
│   ├── personas.md                  # Expert persona definitions
│   ├── rubric.md                    # Scoring rubric quick reference
│   └── evaluation_template.md       # Structured output template
├── README.md
└── LICENSE

See Also

Contributing

PRs welcome! Please open an issue first to discuss changes.

License

MIT

About

Claude agent skill: Score any video ad with an AI expert panel. 8-dimension rubric + 3 specialist personas.

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages