Claude-Skills marketing-psychology

install
source · Clone the upstream repo
git clone https://github.com/borghei/Claude-Skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/borghei/Claude-Skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/marketing/marketing-psychology" ~/.claude/skills/borghei-claude-skills-marketing-psychology && rm -rf "$T"
manifest: marketing/marketing-psychology/SKILL.md
source content

Marketing Psychology

Applied behavioral science for marketing — identifying which psychological principles apply to specific challenges and showing exactly how to implement them.


Table of Contents


Keywords

marketing psychology, behavioral science, cognitive biases, persuasion techniques, mental models, consumer behavior, decision-making, neuromarketing, conversion psychology, pricing psychology, loss aversion, social proof, anchoring, scarcity, reciprocity, framing effect, endowment effect, cognitive load, choice architecture, nudge theory, behavioral economics


Quick Start

Diagnose Why Something Is Not Converting

  1. Identify the desired behavior (click, buy, share, return)
  2. Identify the current friction (too many choices, unclear value, no urgency)
  3. Map the visitor's emotional state (excited, skeptical, confused, impatient)
  4. Match to applicable psychological principles from the catalog
  5. Implement 2-3 principle-based changes with specific execution

Apply Psychology to a Marketing Asset

  1. Select the asset (landing page, pricing page, email, ad)
  2. Review the applicable psychology from the Application by Challenge section
  3. Choose 3-5 principles to apply
  4. Implement each with the specific technique described
  5. Measure the impact through A/B testing

Core Workflows

Workflow 1: Behavioral Diagnosis

When something is not converting, diagnose through a behavioral lens:

Step 1: Map the Decision Journey

StageWhat Visitor DoesWhat Visitor FeelsPotential Barriers
ArrivalLands on pageCurious or skepticalNo immediate value recognition
EvaluationReads contentInterested or confusedToo much information, unclear benefits
ComparisonConsiders alternativesAnalyticalNo differentiation visible
DecisionApproaches CTAHesitantRisk perception, friction, objections
ActionClicks/purchasesCommitted or uncertainForm complexity, hidden costs, trust deficit

Step 2: Identify Behavioral Barriers

For each stage, check for these barrier types:

Barrier TypeDescriptionExample
Cognitive loadToo much to process15 pricing options, walls of text
Choice paralysisToo many options6 plans with unclear differences
Loss aversionFear of making wrong choiceNo guarantee, no trial, no refund
Trust deficitNot enough credibilityNo social proof, no named testimonials
Status quo biasEffort of switching feels too highNo migration support, complex setup
FrictionToo many steps to complete actionLong forms, mandatory account creation

Step 3: Prescribe Principles

Match each barrier to the psychological principle that addresses it. See the catalog below.

Workflow 2: Principle Application

Step 1: Select 3-5 Relevant Principles

Do not apply every principle at once. Select the 3-5 most relevant to the specific challenge.

Step 2: Implement Concretely

For each principle, define:

  • Where on the page/flow it applies
  • What specific change to make
  • What the expected behavioral impact is

Step 3: Test and Measure

Every psychology-based change should be A/B tested:

  • Hypothesis: "Applying [principle] to [element] will increase [metric] because [behavioral reason]"
  • Test duration: minimum 14 days or 1,000 visitors per variant
  • Success metric: conversion rate, click rate, or engagement rate

Mental Model Catalog

Buyer Psychology (Decision-Making)

PrincipleDefinitionMarketing Application
Loss AversionPeople feel losses 2x more than equivalent gainsFrame benefits as what they will miss without your product
AnchoringFirst number seen sets expectations for all subsequent numbersShow higher price first (original price, competitor price) before showing yours
Social ProofPeople follow the actions of othersShow customer count, testimonials, logos, review scores
ScarcityLimited availability increases perceived valueShow real constraints (limited seats, deadline-based pricing)
Paradox of ChoiceToo many options leads to decision paralysisLimit to 3 pricing tiers, highlight the recommended one
Endowment EffectPeople value things more once they feel ownershipFree trials, saved progress, personalized dashboards
Zero-Price Effect"Free" is disproportionately attractiveOffer a free tier or free trial (not just "cheap")
Status Quo BiasPeople prefer the current state unless motivated to changeShow the cost of doing nothing, make switching easy
Framing EffectSame information presented differently changes decisions"95% uptime" vs "down 18 days/year" — choose the frame wisely
Sunk Cost FallacyInvested time/money makes people continue even when irrationalShow progress toward goals, remind of time invested
Bandwagon EffectPeople adopt behaviors that appear popular"Most popular plan," "Trending," "Join 10,000+ teams"
Peak-End RuleExperiences judged by peak moment and endingMake the best feature prominent, make offboarding pleasant

Persuasion and Influence

PrincipleDefinitionMarketing Application
ReciprocityPeople feel compelled to return favorsGive value first (free tool, audit, guide) before asking
Commitment & ConsistencySmall yes leads to bigger yesStart with micro-commitments (email signup before demo request)
AuthorityPeople defer to credible expertsExpert endorsements, credentials, certifications, media mentions
LikingPeople buy from those they likeBrand personality, relatable stories, shared values
Unity PrincipleShared identity strengthens influence"Built by marketers, for marketers" community framing
Contrast EffectItems seem different when placed next to contrasting itemsShow competitor comparison, before/after, or price anchoring
Mere ExposureRepeated exposure increases preferenceRetargeting, consistent branding, regular content publishing
Pratfall EffectAdmitting a small flaw increases credibility"We're not for everyone" messaging, honest limitations

Pricing Psychology

PrincipleDefinitionMarketing Application
Charm Pricing$49 feels significantly cheaper than $50 (left-digit effect)Price at .99 or .95 endings for consumer, round numbers for premium
Decoy EffectA dominated option makes the target option look betterAdd a third tier that makes your target tier the obvious choice
Rule of 100Under $100: show % discount. Over $100: show $ discount.$80 product: "25% off." $500 product: "$125 off."
Good-Better-BestThree tiers with increasing value make the middle most popularDesign middle tier as your target with best value positioning
Price AnchoringShow higher number first to make actual price feel reasonable"Usually $199/mo — now $99/mo" or "Enterprise plans start at $499"
Pennies-a-DayDaily cost framing feels cheaper than monthly"$3.29/day" feels cheaper than "$99/month"
Pain of PayingEvery payment creates psychological frictionAnnual billing (one payment vs. twelve), free trial (delay payment)

Design and UX Psychology

PrincipleDefinitionMarketing Application
Hick's LawMore choices = more time to decide (and less likely to decide)Fewer form fields, fewer navigation options, clear primary CTA
Fitts's LawLarger, closer targets are easier to clickLarge CTA buttons, prominent placement
Von Restorff EffectDistinctive items are remembered betterHighlight recommended plan, use contrasting color for CTA
Zeigarnik EffectIncomplete tasks create mental tensionProgress bars, "3 steps left," incomplete profile prompts
Cognitive FluencyEasy-to-process information is more persuasiveSimple language, clean design, familiar patterns
Default EffectPeople tend to accept the default optionPre-select the recommended plan, pre-check annual billing
Fogg Behavior ModelBehavior = Motivation + Ability + Prompt at same momentHigh-motivation moment + easy action + visible CTA

Growth Psychology

PrincipleDefinitionMarketing Application
Network EffectsProduct becomes more valuable as more people use itCollaborative features, shared workspaces, team invites
IKEA EffectPeople value things they helped create moreUser customization, personalized setup, co-created content
Goal-Gradient EffectPeople accelerate effort as they approach a goalProgress bars near completion, "You're 80% there" messaging
Switching CostsHigher switching costs increase retentionData lock-in, workflow integration, team adoption depth
Variable RewardsUnpredictable rewards are more engaging than predictable onesFeature announcements, surprise upgrades, varied content
CompoundingSmall improvements that accumulate over timeShow cumulative value: "You've saved 47 hours this quarter"

Application by Marketing Challenge

Landing Page Not Converting

PrincipleWhere to ApplySpecific Change
Loss AversionHeadlineFrame as what they lose without you, not what they gain
Social ProofBelow heroCustomer count, logos, or star rating visible above fold
AnchoringNear CTAShow the value they get vs. the price they pay
Hick's LawNavigationRemove all navigation links — one page, one CTA
Cognitive FluencyThroughoutSimplify language, increase white space, reduce choices

Pricing Page Optimization

PrincipleWhere to ApplySpecific Change
Decoy EffectPlan structureAdd a tier that makes your target tier the obvious value choice
Charm PricingPrice displayUse $49 not $50 (consumer) or round $100 (enterprise)
Good-Better-BestTier designThree tiers, middle is "Most Popular," clearly highlighted
AnchoringTop of pageShow highest price or enterprise price first
Default EffectTogglePre-select annual billing (saves them money, you get commitment)
Zero-Price EffectFree tierIf free tier exists, make it clearly useful but limited

Email Engagement

PrincipleWhere to ApplySpecific Change
Zeigarnik EffectSubject lineOpen loops: "The one thing we got wrong about..."
ReciprocityEmail contentGive genuine value before asking for anything
Goal-GradientOnboarding"You're 2 steps from your first dashboard"
CommitmentMicro-asksStart with easy asks (reply to this email) before hard asks (book a demo)
Curiosity GapPreview textCreate knowledge gap that the email body closes

Reducing Churn

PrincipleWhere to ApplySpecific Change
Endowment EffectCancel flowShow what they will lose (data, history, integrations)
Sunk CostCancel flow"You've created 47 dashboards and saved 120 hours"
Loss AversionRetention email"Without [Product], you'll go back to [painful manual process]"
Switching CostsProductDeep integrations, team workflows, embedded in daily routine
Status Quo BiasThroughoutMake staying easy, make leaving feel effortful

Ad Creative Improvement

PrincipleWhere to ApplySpecific Change
Mere ExposureRetargetingShow consistent branding across multiple touchpoints
Contrast EffectAd copyBefore/after comparison, competitor comparison
FramingHeadlineFrame the same benefit from a loss vs. gain perspective
Social ProofAd body"Join 10,000+ teams" or customer testimonial snippet
Pratfall EffectBrand messaging"We're not the cheapest — but teams stay 3x longer"

Pricing Psychology Framework

Three-Tier Pricing Design

Tier 1 (Starter): Anchors the low end. Useful but limited. Makes Tier 2 look like great value.

Tier 2 (Growth — Target Tier): The one you want most people to buy. Best value ratio. Label as "Most Popular" or "Recommended."

Tier 3 (Enterprise): Anchors the high end. Makes Tier 2 feel affordable by comparison. Custom pricing creates exclusivity.

Decoy Pricing Example

Without decoy (equal attractiveness):

  • Basic: $19/mo (5 users)
  • Pro: $49/mo (25 users)

With decoy (Pro becomes obvious choice):

  • Basic: $19/mo (5 users)
  • Plus: $39/mo (10 users) ← Decoy: close to Pro price, much less value
  • Pro: $49/mo (25 users) ← Now clearly the best value

Price Display Best Practices

  • Show monthly price even when billing annually (it is a smaller number)
  • Pre-select annual billing as the default
  • Show the savings: "Save 20% with annual billing"
  • Enterprise tier: "Contact us" or "Custom" (no fixed price — enables value-based selling)
  • Include "per user" only if the per-user price is low ($5-15/user)
  • For usage-based: show an example calculation ("For a team of 10, that is $X/month")

Conversion Psychology Playbook

The Trust Cascade

Trust must be built in sequence. Visitors will not convert until sufficient trust is established:

1. Visual Trust (0-3 seconds)
   → Professional design, brand consistency, no visual errors
   → If this fails, visitor bounces immediately

2. Relevance Trust (3-10 seconds)
   → Headline matches their need, content speaks their language
   → If this fails, visitor leaves without scrolling

3. Credibility Trust (10-60 seconds)
   → Social proof, authority signals, specific claims
   → If this fails, visitor evaluates competitors instead

4. Risk Trust (60+ seconds)
   → Guarantee, free trial, easy cancellation, clear pricing
   → If this fails, visitor abandons at the CTA

Micro-Commitment Ladder

Build toward the big ask through small steps:

Read a blog post (zero commitment)
↓
Download a guide (email exchange)
↓
Start a free trial (product experience)
↓
Activate a key feature (value realization)
↓
Upgrade to paid (financial commitment)
↓
Expand to team (organizational commitment)

Each step increases commitment incrementally. Do not ask for the big commitment first.


Copy Psychology Techniques

Loss-Framed vs. Gain-Framed Headlines

Gain-FramedLoss-Framed (usually stronger)
"Save 4 hours every week""Stop losing 4 hours every week"
"Get more leads""Stop letting leads slip through"
"Improve your conversion rate""Your conversion rate is costing you $X"

Specificity Bias

Specific claims are more believable than round numbers:

  • "Save 37% on infrastructure costs" beats "Save over 30%"
  • "2,847 teams" beats "thousands of teams"
  • "Setup in 8 minutes" beats "Setup in minutes"

Future Pacing

Help readers visualize the outcome:

  • "Imagine opening your dashboard Monday morning and seeing every metric you need, already organized."
  • "Picture your next board meeting where you present data you trust, not data you spent all weekend assembling."

Ethical Guidelines

The Line Between Persuasion and Manipulation

Persuasion (ethical): Helping people make decisions that are genuinely good for them, using psychological insights to remove barriers and communicate value clearly.

Manipulation (unethical): Exploiting cognitive biases to trick people into decisions that are not in their interest.

Principles for Ethical Application

  1. Transparency — If you would be embarrassed to explain the technique to the customer, do not use it.
  2. Alignment — Every psychological technique should help the customer reach a decision that is genuinely good for them.
  3. Reversibility — If the customer changes their mind, make it easy to reverse the decision (easy cancellation, refunds).
  4. Honesty — Scarcity must be real. Social proof must be real. Claims must be verifiable.
  5. Proportionality — Do not use high-pressure techniques for low-stakes decisions.

Specific Ethical Boundaries

  • Scarcity: Only use when the constraint is real (limited seats, deadline pricing, inventory).
  • Social proof: Only show real testimonials, real numbers, real logos with permission.
  • Urgency: Only create urgency when a genuine deadline exists.
  • Dark patterns: Never hide unsubscribe options, pre-check unwanted options, or make cancellation deliberately difficult.

Best Practices

  1. Diagnose before prescribing — Understand what behavioral barrier exists before applying a principle. Random psychology application is noise.

  2. Apply 2-3 principles, not 20 — Overloading a page with every psychological technique creates cognitive overwhelm.

  3. Test everything — Psychology provides hypotheses. Data provides answers. A/B test every change.

  4. Context matters — Social proof that works for consumer SaaS may not work for enterprise. Adapt to your audience.

  5. Ethics first — If a technique feels manipulative, it probably is. Long-term trust outperforms short-term conversion.

  6. Combine principles — The most effective implementations combine 2-3 complementary principles (e.g., social proof + scarcity + loss aversion near CTA).

  7. Specificity wins — "2,847 teams" is more psychologically compelling than "thousands of teams" because specific numbers trigger credibility bias.

  8. Study the science — Read Kahneman, Cialdini, Ariely, and Thaler for deep understanding. Surface-level application produces surface-level results.

  9. Monitor for diminishing returns — Psychological techniques lose effectiveness over time as audiences become desensitized. Refresh regularly.

  10. Document learnings — Every A/B test teaches something about your audience's psychology. Build a knowledge base of what works for your specific audience.


Integration Points

  • Copywriting — Apply psychological principles when writing page copy (headlines, CTAs, objection handling).
  • Landing Page Generator — Use psychology to guide page structure and section ordering.
  • Paid Ads — Apply ad-specific psychology (mere exposure, contrast effect, curiosity gap) to creative.
  • Pricing — Apply pricing psychology (anchoring, decoy, charm pricing) to pricing page design.
  • Copy Editing — Use the Heightened Emotion sweep to apply psychology during editorial review.
  • Marketing Context — Understanding customer psychology informs positioning and messaging strategy.

Troubleshooting

SymptomLikely CauseFix
Page feels persuasive but doesn't convertMissing trust cascade (visual > relevance > credibility > risk)Build trust in sequence. Run
persuasion_auditor.py
to find gaps.
Pricing page has high drop-offNo anchoring, no decoy, no recommended planRun
pricing_psychology_analyzer.py
. Add 3-tier structure with highlighted middle tier.
Social proof present but not workingGeneric testimonials without specificityReplace "Great product!" with named testimonials + specific metrics + outcomes.
Scarcity messaging feels manipulativeFake constraints (countdown timers, fake "limited")Only use scarcity when genuine. Fake scarcity erodes trust permanently.
Too many principles applied at onceCognitive overload from stacking 10+ techniquesApply 2-3 complementary principles, not everything. Less is more.
Loss-framed headlines not performingAudience is solution-aware, not problem-awareMatch framing to awareness level. Solution-aware audiences respond to gain framing.
Users abandon during long formsFriction too high, no progress indicatorsApply Zeigarnik effect: add progress bars. Reduce fields to minimum.

Success Criteria

  • Cialdini principle coverage: 4+ of 7 principles applied on key conversion pages
  • Every pricing page uses anchoring, recommended plan highlight, and risk reversal
  • A/B test running on every psychology-based change (hypothesis + measurement)
  • Loss-framed and gain-framed headline variants tested (loss framing typically wins 60-70%)
  • Social proof includes specific numbers (not "thousands" but "2,847 teams")
  • Ethical guidelines followed: all scarcity real, all claims verifiable, easy cancellation
  • Document learnings: build audience-specific psychology knowledge base from test results

Scope & Limitations

In Scope: Behavioral psychology principles applied to marketing, conversion optimization, pricing strategy, copy improvement, campaign design. 70+ mental models with implementation guides.

Out of Scope: Academic psychology research, clinical applications, UX research methodology (use product-team), A/B test statistical analysis tools, consumer psychology outside marketing context.

Limitations: Psychology provides hypotheses, not certainties. All changes must be A/B tested. What works for consumer SaaS may not work for enterprise. Cultural context matters significantly. Principles should be applied ethically -- persuasion that helps customers make good decisions, not manipulation.


Python Automation Tools

1. Persuasion Auditor (
scripts/persuasion_auditor.py
)

Audits marketing copy for Cialdini's 7 principles plus behavioral economics techniques. Identifies what's applied and what's missing.

python scripts/persuasion_auditor.py page.html
python scripts/persuasion_auditor.py landing_page.txt --json

2. Cognitive Bias Checker (
scripts/cognitive_bias_checker.py
)

Identifies cognitive biases being leveraged (or missed) in marketing copy, pricing pages, and landing pages.

python scripts/cognitive_bias_checker.py pricing_page.html
python scripts/cognitive_bias_checker.py page.txt --json

3. Pricing Psychology Analyzer (
scripts/pricing_psychology_analyzer.py
)

Analyzes pricing page structure for anchoring, decoy effect, charm pricing, framing, and tier design.

python scripts/pricing_psychology_analyzer.py pricing.json
python scripts/pricing_psychology_analyzer.py --sample --json