Skip to content

Add hook evaluator — first judge in judges/ collection - #1

Open
rezakhadjavi wants to merge 3 commits into
mainfrom
add-hook-judge
Open

Add hook evaluator — first judge in judges/ collection#1
rezakhadjavi wants to merge 3 commits into
mainfrom
add-hook-judge

Conversation

@rezakhadjavi

Copy link
Copy Markdown

Summary

  • Adds judges/hook-evaluator/ — a skill that evaluates ad hooks for scroll-stopping power, returning PASS/FAIL with psychological trigger analysis and improvement suggestions
  • Calibrated against real thumbstop performance data ($1B+ in ad spend)
  • Creates the judges/ folder as a new category that can grow with additional evaluation skills over time (concept judge, script judge, etc.)
  • Converts what was previously an MCP server into a self-contained skill — no API calls, no infrastructure, just prompt-driven evaluation any agent can run

What changed

  • New: judges/hook-evaluator/SKILL.md — the evaluator skill
  • Updated: marketplace.json — registers the new skill
  • Updated: README.md — adds the evaluator to the skills table, example prompts, and pipeline flow

How it fits the pipeline

Hooks Writing → Hook Evaluator (quality gate) → Ad Concept → UGC Script

The evaluator sits between generation and concept development as a quality filter. Users generate hooks, evaluate them, rewrite failures using the suggestions, and only develop passing hooks into concepts.

Test plan

  • Install skills and verify hook-evaluator activates on trigger phrases ("grade my hooks", "evaluate these hooks")
  • Evaluate known strong/weak hooks against calibration data
  • Verify companion skill references resolve correctly

🤖 Generated with Claude Code

Reza Khadjavi and others added 3 commits March 24, 2026 20:17
Converts the hook-eval MCP into a self-contained skill. The evaluator
classifies hooks as PASS/FAIL using psychological trigger analysis
calibrated against real thumbstop performance data. The judges/ folder
is designed to grow with additional evaluation skills over time.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Replaces the buried **Note:** CTAs with a consistent "With Real Data"
section at the end of each action skill. Each section is contextual to
what that skill just helped with, names the specific limitation (no real
performance data), and positions Motion + the upcoming MCP as the
natural next step.

Applied to: hook-writing, ad-concept-generator, ugc-scriptwriter,
judges/hook-evaluator. Skipped reference-only skills (hook-tactics,
hook-voice-patterns) since they're libraries, not workflows.

Also adds motion-product-context.md as a shared source of truth for
Motion's platform capabilities and the upcoming MCP server.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Strip "Coming soon" MCP teaser from all skill files and the shared
product context. We'll add these back when the Motion MCP is live.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant