mcpField
C
copy-validator

copy-validator

github.com/shipshitdevMarketing & growth38128 installsUpdated 2d ago
Repository

About copy-validator

copy-validator is a marketing skill for assessing sales copy with the Hook-Story-Offer scorecard. It scores six dimensions, identifies weak points, and provides rewrites before publication.

Key features

  1. 01Hook-Story-Offer scoring
  2. 02Weighted six-dimension review
  3. 03Overall rating out of 100
  4. 04Diagnosis and conversion impact
  5. 05Rewrites for weak sections

Use cases

  1. 01Review landing-page copy before publishing
  2. 02Assess email or ad copy
  3. 03Find weaknesses in a headline or call to action

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/shipshitdev/skills --skill copy-validator

After installing, type/copy-validatorin Claude Code to confirm it loaded.

Bundled filesplugin.jsonreferences/full-guide.md

Details

From the project README

Copy Validator - Hook-Story-Offer Scorecard

Overview

Ruthlessly assess sales copy against Russell Brunson's Hook-Story-Offer framework combined with classic direct response principles. Score objectively, expose weak points, provide rewrites.

Brunson's Core Principle: "The hook grabs them, the story connects them, the offer converts them."

When This Activates

  • "validate my copy"
  • "rate my copy" / "rate my headline"
  • "is my copy good"
  • "why isn't my copy converting"
  • Checking copy before publishing
  • Landing page, email, or ad copy feedback

The Framework: Hook-Story-Offer Scorecard

HOOK (Stop + Engage) → STORY (Connect + Believe) → OFFER (Desire + Act)

Scoring Dimensions (6 total):

DimensionWeightWhat It Measures
Hook Power2xDoes the headline stop and engage?
Story Resonance1.5xDoes the story create emotional connection?
Proof Stacking1.5xIs there enough evidence to believe?
Offer Presentation2xIs the offer clear and desirable?
Urgency/Scarcity1xIs there a reason to act NOW?
CTA Strength1xIs the call-to-action compelling and clear?

Max Score: 100 points

Quick Workflow

  1. Gather copy - Type, goal, audience, full text
  2. Score Hook (0-10) - Stops scroll? Specific promise? Tension?
  3. Score Story (0-10) - Origin story? Relatability? Transformation?
  4. Score Proof (0-10) - Testimonials? Social proof? Believable?
  5. Score Offer (0-10) - Clear? Value stack? Benefits over features?
  6. Score Urgency (0-10) - Legitimate scarcity? Clear deadline?
  7. Score CTA (0-10) - One clear CTA? Outcome-focused? Risk reversal?
  8. Calculate total - Apply weights, generate rating

Rating Scale

ScoreRatingVerdict
85-100Conversion CopyReady to run. Minor polish only.
70-84Strong CopyGood foundation. Fix weak points.
55-69Leaky CopySignificant gaps. Improve before running.
40-54Weak CopyMajor issues. Rewrite key sections.
0-39Broken CopyStart over. Fundamental problems.

For Dimensions Below 7, Provide

  1. What's wrong (specific diagnosis)
  2. Why it hurts (impact on conversion)
  3. Rewrite (show exactly what to change)

Integration

SkillWhen to Use
funnel-validatorValidate the full funnel, not just copy
offer-validatorValidate the core offer structure
expert-validatorValidate positioning and messaging strategy
offer-architectIf offer itself needs rebuilding

For complete scoring criteria, hook formulas, story elements checklist, proof types, offer presentation formulas, CTA formulas, output format template, and example validations, see: references/full-guide.md

Comments

Markdown supported