Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
joellewis avatar

Finance Psychology

  • 441 installs
  • 161 repo stars
  • Updated July 18, 2026
  • joellewis/finance_skills

finance-psychology is a Claude Code skill that models cognitive biases and money psychology so developers building wealth, trading, or robo-advisory products can align features and copy with real investor behavior.

About

finance-psychology is a wealth-management plugin skill in JoelLewis/finance_skills (part of an 84-skill, 7-plugin finance marketplace) that encodes behavioral finance for fintech product design. It covers nine documented cognitive biases—from loss aversion (~2× pain vs gains) through herding and confirmation bias—with mitigation tables, four client money archetypes (Avoider, Optimizer, Worrier, Dreamer), and a four-bucket spending plan (50–60% fixed, 10%+ investments, 5–10% savings, 20–35% guilt-free). Worked examples walk through disposition effect, panic selling after drawdowns, and couples money dynamics with monthly meeting agendas. Use finance-psychology when defining risk questionnaires, panic-sell guardrails, onboarding copy, or advisory UX—not for tax calculations, order execution, or compliance rule lookup.

  • Maps common cognitive biases to product safeguards
  • Frames risk tolerance and loss-aversion scenarios
  • Informs disclosure, nudge, and default-policy choices
  • Aligns advisory UX with regulated advice boundaries

Finance Psychology by the numbers

  • 441 all-time installs (skills.sh)
  • +15 installs in the week ending Aug 2, 2026 (Skillselion tracking)
  • Ranked #229 of 1,106 Finance & Trading skills by installs in the Skillselion catalog
  • Data as of Aug 2, 2026 (Skillselion catalog sync)
npx skills add https://github.com/joellewis/finance_skills --skill finance-psychology

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs441
repo stars161
Last updatedJuly 18, 2026
Repositoryjoellewis/finance_skills

How do cognitive biases affect fintech product design?

Model investor behavior, bias, and risk tolerance when scoping robo-advisory, wealth, or trading features so product rules and copy match real decision psychology.

Who is it for?

Developers and product engineers building wealth, trading, or robo-advisory apps who need behavioral finance rules for UX, copy, and risk guardrails.

Skip if: Skip finance-psychology for portfolio math, tax-loss harvesting calculations, SEC/FINRA compliance lookups, or pure quantitative backtesting.

When should I use this skill?

User mentions behavioral finance, loss aversion, panic selling, money scripts, emotional investing, or couples money conflict in a fintech product context.

What you get

Bias mitigation tables, money-type personas, four-bucket framework references, and coaching conversation patterns embedded in product requirements or UX copy.

  • Bias mitigation requirements
  • Persona and money-type definitions
  • UX copy and guardrail recommendations

By the numbers

  • Covers 9 cognitive biases in a structured mitigation table
  • Defines 4 client money archetypes (Avoider, Optimizer, Worrier, Dreamer)
  • Sits in an 84-skill finance-skills marketplace across 7 plugins

Files

SKILL.mdMarkdownGitHub ↗

Finance Psychology — Behavioral Finance & Money Coaching

Personal finance is mostly psychology, not mechanics. Until a client understands why they behave the way they do with money, and what they want money to do for them, spreadsheet optimization will not stick. This skill covers the coaching principles, client archetypes, cognitive biases, and conversation frameworks for behavioral money work.

Core Concepts

Foundational Principles

Short principles that should inform every coaching interaction:

  • No one is crazy. Financial behavior that looks irrational usually made sense in the lived experience that produced it. Ask "what experience taught you this was the right way to handle money?" before trying to change the behavior.
  • Luck and risk are real. Judge decisions by process, not outcome. This reduces both the overconfidence that follows wins and the shame that follows losses.
  • Define "enough" explicitly. Social comparison keeps the goalpost moving; no number feels sufficient if the reference point keeps shifting. Help clients name "enough" as a life, in writing — and never risk reputation, freedom, family, or happiness for more.
  • Compounding requires time, not heroics. Years invested matter more than return rate. Anything that interrupts compounding — panic selling, lifestyle inflation that eliminates savings, blow-up risk — is more destructive than earning merely average returns.
  • Getting wealthy and staying wealthy are different skills. Growth requires optimism and risk-taking; preservation requires humility, margin of safety, and liquidity. Coach risk-takers on preservation and natural savers on deployment.
  • Freedom is the underlying goal. When a client names a number, probe for the freedom underneath ("what would that let you do?") — it is often achievable earlier than the number.
  • Wealth is what you don't see. Visible spending is wealth already converted to consumption. Rich is current income; wealth is future optionality.
  • Reasonable beats rational. A slightly suboptimal plan the client can hold through a 35% drawdown beats an optimal plan they abandon. Ask: "If this dropped 35% next month, would you change anything?" If the answer is sell, de-risk now.

(Sources: Housel, Kahneman & Tversky, Thaler & Sunstein, Sethi — see Key Sources.)

Invisible Money Scripts

Unconscious beliefs about money absorbed from family and early experience: "we can't afford that" (scarcity even amid abundance), "rich people are greedy" (self-sabotage), "investing is gambling" (cash paralysis), "don't talk about money" (can't negotiate or discuss finances with a partner).

Identification: Ask "What did your parents say about money when you were growing up? What did they not say?" Listen for reflexive phrases ("I probably shouldn't spend that much") — scripts operating in real time.

Coaching approach: Name the script explicitly. Frame it as an inherited survival strategy that made sense in its original context; the client gets to choose which scripts to keep.

The Four Money Types

Most clients blend archetypes, but one usually dominates. Identify it to tailor the coaching approach.

The Avoider — deflects money conversations, doesn't know balances, defers decisions to a partner; rooted in anxiety. Coaching moves: Start small and concrete (log into one account, not a full plan). Celebrate engagement, not optimization. Automate heavily so the system works when they aren't looking.

The Optimizer — tracks every dollar, comparison-shops for hours, but often cannot spend on things that bring joy; optimizes the system at the expense of the life it serves. Coaching moves: Zoom out: "Your savings rate is 38% — what is that saving for?" Challenge them to spend more on their highest-value categories. Redirect optimization energy from cost-minimization to life-design, and from trivial questions to the big levers (below).

The Worrier — plays defense, sees threats everywhere; anxiety does not match objectively healthy finances. Coaching moves: Give data and structure: concrete projections under pessimistic/base/optimistic scenarios. Build generous margins of safety — not because the math requires it, but because it buys emotional permission to live. Name the feelings-vs-reality gap compassionately.

The Dreamer — magical thinking; big plans, no mechanism; often insulated by a partner or avoidance. Coaching moves: Don't crush the vision — connect it to a mechanism: "The restaurant in five years — what does it cost, what's the monthly saving, what's the first step this week?"

Spending as Values Expression

Identify the few categories where spending produces disproportionate joy (Sethi calls these "Money Dials"): ask "What do you spend on that makes you irrationally happy?" and "What do you spend on that you genuinely don't care about?" Then spend deliberately more on the first and cut mercilessly on the second. This replaces moralistic "good/bad spending" with a personalized values test: not "is this too much?" but "does this reflect what you actually value?"

Big Levers vs Trivial Questions

Most people obsess over trivial questions (cancel a $12 subscription?) while ignoring the decisions worth tens of thousands: asset allocation and fees, savings rate, debt sequencing, career and salary negotiation, insurance, tax-advantaged account order (employer match → Roth IRA → max 401k → HSA). When a client fixates on a small optimization, redirect to the unaddressed big levers — small optimizations are often avoidance of the hard, high-stakes questions.

Start at 85%, Then Iterate

A plan that is 85% optimal and actually implemented beats a perfect plan stalled in research. Four index funds are functionally identical; pick one and start. Automation and consistency beat precision.

The Four-Bucket Spending Plan

A values-aligned alternative to a restrictive budget (the word "budget" itself triggers scarcity for many clients):

  • Fixed costs: 50-60% of take-home
  • Investments: 10%+
  • Savings: 5-10%
  • Guilt-free spending: 20-35% — meant to be spent, because the important categories are already funded

The guilt-free bucket flips the emotional valence of discretionary spending and breaks the guilt → deprivation → binge cycle. This is deliberate, constructive mental accounting.

Automation as Behavioral Architecture

Remove willpower from the loop: paycheck → pre-tax retirement contribution → automatic transfers to IRA/savings/investments → auto-paid bills → remainder is guilt-free. Automation leverages status quo bias, cuts decision fatigue, and reduces money management to ~90 minutes a month.

Cognitive Biases in Financial Decisions

BiasTypical damagePrimary mitigations
Loss aversion (losses hurt ~2x gains; Kahneman & Tversky 1979)Disposition effect: sell winners early, hold losers hoping to break evenPre-commit exit criteria at purchase; rules-based rebalancing; "would I buy this today at this price?"; purchase price is a sunk cost
OverconfidenceOvertrading, concentration, underestimating tail riskTrack prediction hit rate; base rates (~10-15% of active pickers beat the index over 10 years); accept that average returns sustained are excellent
AnchoringFixating on purchase price or 52-week highValue on current fundamentals; multiple independent valuation methods
Recency biasPerformance chasing; panic selling; extrapolating trendsLong-term return distributions; 20%+ drawdowns recur every ~4-6 years — the price of admission, not an anomaly; DCA and systematic rebalancing
HerdingBuying euphoric tops, selling panicked bottomsPre-committed IPS with rebalancing bands; pause when the urge to follow the crowd is strongest
Mental accounting"House money" risk-taking; low-yield savings beside high-interest debtRecognize fungibility — but harness it deliberately (guilt-free bucket) when it enables good behavior
Status quo biasNever rebalancing; staying in high-fee fundsHarness via defaults: auto-enrollment (~50%→~90% participation), auto-escalation; "would I build this portfolio from scratch today?"
Confirmation biasReading only bullish research on holdingsSeek the strongest opposing argument; pre-mortem ("it's a year later and this failed — why?")
Framing effectsSame facts, different decisions ("90% survival" vs "10% mortality"; nominal vs real)Reframe every major decision multiple ways; present both gains and losses, percentages and dollars

Knowing about biases does not eliminate them — debiasing requires structural safeguards: written rules, automation, cooling-off periods (48-72 hours before any news-driven trade), and accountability.

Coaching Couples Through Money Conversations

Money is a leading source of relationship conflict, usually because couples have never had a structured money conversation.

First conversation: 15-20 minutes maximum. Lead with feelings, not accusations ("I feel anxious when..." not "You always..."). Start with the shared vision, not the problems. Avoid trigger words: "budget," "you always/never," shame-loaded phrases.

Monthly Money Meeting agenda (keep to one hour): 1. Open with appreciation — name something your partner did with money that you valued. 2. Review the numbers together — income, expenses, goal progress. Keep it factual. 3. Discuss vision progress — what moved forward? What's one thing to experience this month? 4. End on something positive.

Couple-dynamic playbooks:

  • Avoider + Optimizer: The Optimizer manages everything and resents it; the Avoider feels controlled and disengages further. Play: give the Avoider full ownership of one bounded area (e.g., the vacation fund); structure conversations via the monthly meeting so the Avoider isn't ambushed; challenge the Optimizer's trivial-vs-big-lever balance.
  • Worrier + Dreamer: Catastrophe vs magic — they talk past each other. Play: make the Dreamer's vision concrete with numbers; show the Worrier the numbers support more freedom than they feel.
  • Both partners must engage. One "innocent" partner who touches nothing creates fragility and resentment.

Visioning Before Tactics

Before tactical work, have the client articulate a specific, vivid picture of the life money should enable (a "Rich Life" vision): fill-in-the-blank prompts ("a perfect ordinary Tuesday in 10 years looks like ______"), an inventory of what makes them irrationally happy, a designed perfect day, and a 10-year "what would I regret not doing?" list. Two rules: get specific (vagueness enables procrastination), and live part of the vision now while building toward the rest — this is not deferred gratification.

Worked Examples

Example 1: Disposition Effect — Holding a Loser

Given: Investor bought XYZ at $100; now $80 after two quarters of declining revenue, a lost major customer, and a new competitor. "I can't sell now — I'd be locking in a loss."

Approach: Name the bias (loss aversion → disposition effect; the $100 anchor). Reframe: purchase price is sunk — "If you held $80 in cash, would you buy XYZ today?" The original thesis is broken, so the rational action is to sell regardless of cost basis (tax-loss harvesting is a tangible consolation). Safeguard: write exit criteria at purchase time ("re-evaluate at -15% or two consecutive revenue misses").

Example 2: Recency Bias — Panic After a Drawdown

Given: After a 25% drawdown: "The market is broken. I'm going to cash."

Approach: Validate the emotion first. Provide context: 20%+ drawdowns recur every ~4-6 years and every prior bear market has been followed by recovery — volatility is the price of admission. Quantify the timing cost: selling now converts a paper loss into a need to time re-entry (two correct decisions instead of zero), and the best days cluster near the worst. Revisit the horizon ("retirement is 20 years away"). If they must act, offer a reasonable compromise — trim equity 5-10%, not 100%. Reasonable beats rational.

Example 3: The Couple Who Can't Spend

Given: Couple earning $280K, $1.2M invested, no debt, no vacation in four years: "We can't justify $8,000 on a trip when we could invest it."

Approach: Identify types (Optimizer with Worrier traits + disengaged partner). Surface the script ("What did your parents say about spending on vacations?") and test it against present reality. Run the numbers: $8,000 at 7% for 20 years is ~$31,000 — and their current savings rate already exceeds the retirement goal with margin, so the trip changes nothing material. Reconnect spending to values: if travel is a core category, spending there is the point of the system. Walk both partners through the visioning exercise — Optimizers often discover their vision includes the experiences they've been denying.

Example 4: Couples Conflict — Avoider + Optimizer

Given: One partner manages everything, tracks every expense, and resents the other "not caring about money." The other feels controlled and shut out; arguments are frequent and circular.

Approach: Name the dynamic without blame — neither approach is wrong, but together they spiral (manage more → disengage more → resent more). Reframe the goal: shared engagement at a level both can sustain, not converting the Avoider into an Optimizer. Install the Monthly Money Meeting to replace ad hoc ambushes. Give the Avoider one bounded area of full ownership. Redirect the Optimizer: "You track every coffee but haven't reviewed investment fees in two years — what if that energy went to the big levers?"

Common Pitfalls

  • Biases are easier to spot in others; self-awareness without structural safeguards changes little.
  • Contrarianism for its own sake is also a bias — it needs independent analysis behind it.
  • Assuming "irrational" is always bad: extra cash held for sleep-at-night comfort may be utility-maximizing. Reasonable > rational.
  • Patronizing tone when naming biases — the goal is to empower, not to win.
  • Jumping to tactics before surfacing scripts, money type, and vision — optimizing a system without knowing what it should produce.
  • Treating a couple as one financial entity: each partner has their own type, scripts, and risk relationship.
  • Letting trivial-question conversations crowd out the big levers.

Cross-References

  • statistics-fundamentals (core plugin): base rates, probability calibration, compounding math
  • time-value-of-money (core plugin): framing decisions in present value terms
  • historical-risk: long-term drawdown context for recency-bias conversations
  • asset-allocation: systematic rebalancing as a debiasing mechanism
  • diversification: structural protection against overconfidence and concentration
  • tax-efficiency: tax-loss harvesting as a consolation for loss aversion; account sequencing
  • performance-reporting: framing effects in how returns are presented; nominal vs real

Key Sources

  • Kahneman, D. & Tversky, A. (1979). Prospect Theory: An Analysis of Decision under Risk.
  • Thaler, R. & Sunstein, C. (2008). Nudge.
  • Housel, M. (2020). The Psychology of Money.
  • Sethi, R. (2019). I Will Teach You to Be Rich; (2024) Money for Couples.

Related skills

How it compares

Use finance-psychology for bias-aware product scoping; pair with historical-risk or asset-allocation skills from the same marketplace for quantitative portfolio mechanics.

FAQ

What triggers the finance-psychology skill?

finance-psychology activates on behavioral finance topics like loss aversion, overconfidence, herd behavior, panic selling, money scripts, lifestyle creep, and emotional investing. The skill also covers couples money conversations and values-driven spending frameworks for advisor

Is finance-psychology only for financial advisors?

finance-psychology targets anyone building wealth, trading, or robo-advisory software who must account for real investor psychology. The skill supplies bias tables, archetypes, and conversation frameworks that inform product rules, guardrails, and user-facing copy.

Finance & Tradingfinancepricing

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.