plugins/wealth-management/skills/finance-psychology/SKILL.md
Recognize and mitigate cognitive biases that impair financial decisions, and coach clients toward values-driven financial lives. Use when the user asks about behavioral finance, money psychology, loss aversion, overconfidence, herd behavior, or emotional investing. Also trigger when users mention 'why do I panic sell', 'money fights with my spouse', 'I can never save enough', 'fear of investing', 'lifestyle creep', 'keeping up with the Joneses', 'Rich Life', 'money scripts', or ask how emotions affect financial decisions.
npx skillsauth add joellewis/finance_skills finance-psychologyInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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.
Short principles that should inform every coaching interaction:
(Sources: Housel, Kahneman & Tversky, Thaler & Sunstein, Sethi — see Key Sources.)
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.
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?"
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?"
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.
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.
A values-aligned alternative to a restrictive budget (the word "budget" itself triggers scarcity for many clients):
The guilt-free bucket flips the emotional valence of discretionary spending and breaks the guilt → deprivation → binge cycle. This is deliberate, constructive mental accounting.
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.
| Bias | Typical damage | Primary mitigations | |------|----------------|---------------------| | Loss aversion (losses hurt ~2x gains; Kahneman & Tversky 1979) | Disposition effect: sell winners early, hold losers hoping to break even | Pre-commit exit criteria at purchase; rules-based rebalancing; "would I buy this today at this price?"; purchase price is a sunk cost | | Overconfidence | Overtrading, concentration, underestimating tail risk | Track prediction hit rate; base rates (~10-15% of active pickers beat the index over 10 years); accept that average returns sustained are excellent | | Anchoring | Fixating on purchase price or 52-week high | Value on current fundamentals; multiple independent valuation methods | | Recency bias | Performance chasing; panic selling; extrapolating trends | Long-term return distributions; 20%+ drawdowns recur every ~4-6 years — the price of admission, not an anomaly; DCA and systematic rebalancing | | Herding | Buying euphoric tops, selling panicked bottoms | Pre-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 debt | Recognize fungibility — but harness it deliberately (guilt-free bucket) when it enables good behavior | | Status quo bias | Never rebalancing; staying in high-fee funds | Harness via defaults: auto-enrollment (~50%→~90% participation), auto-escalation; "would I build this portfolio from scratch today?" | | Confirmation bias | Reading only bullish research on holdings | Seek the strongest opposing argument; pre-mortem ("it's a year later and this failed — why?") | | Framing effects | Same 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.
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):
Couple-dynamic playbooks:
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.
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").
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.
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.
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?"
testing
Model, forecast, and interpret volatility using time-series models and options-implied measures. Use when the user asks about EWMA, GARCH models, implied volatility, volatility surfaces, volatility term structure, or the VIX. Also trigger when users mention 'volatility smile', 'volatility skew', 'realized vs implied vol', 'volatility risk premium', 'vol clustering', 'mean-reverting volatility', 'options pricing inputs', 'RiskMetrics', 'decay factor', or ask how to forecast future volatility for risk management.
testing
Execute a complete tax-loss harvesting workflow from candidate identification through post-harvest monitoring. Use when the user asks about finding TLH candidates, gain/loss budgeting, replacement security selection, wash-sale compliance, or harvest execution planning. Also trigger when users mention 'unrealized losses in my portfolio', 'swap ETFs for tax purposes', 'harvest losses before year-end', 'substantially identical security', 'wash-sale window', 'NIIT offset', 'loss carryforward', or ask how much tax they can save by harvesting.
testing
Maximizes after-tax returns through strategic asset location, gain/loss management, and withdrawal sequencing. Use when the user asks about asset location, Roth conversions, tax-efficient withdrawals, tax lot selection, or charitable giving with appreciated securities. Also trigger when users mention 'which account should I hold bonds in', 'tax drag', 'Roth vs Traditional', 'RMD planning', 'bracket stuffing', 'HIFO vs FIFO', or ask how to minimize taxes on investments. For tax-loss harvesting execution and wash-sale mechanics, see the tax-loss-harvesting skill.
development
Plan and track savings for specific financial goals including retirement, education, and home purchase. Use when the user asks about required savings rates, 529 plans, retirement accumulation targets, down payment planning, or goal prioritization. Also trigger when users mention 'how much do I need to save each month', 'am I on track for retirement', 'college savings', 'safe withdrawal rate', '4% rule', 'FIRE savings rate', 'catch-up contributions', 'employer match', or ask how to balance competing savings goals.