plugins/advisory-practice/skills/financial-planning-workflow/SKILL.md
Orchestrate the complete advisor workflow for assembling and delivering a comprehensive financial plan, from data gathering through recommendations and ongoing monitoring. Use when the user asks about building a financial plan for a client, structuring a planning engagement, coordinating retirement and education and estate goals into one plan, running scenario analysis across a full financial picture, prioritizing competing recommendations, preparing for a plan presentation meeting, or deciding when a plan needs updating. Also trigger when users mention 'comprehensive financial plan', 'discovery meeting', 'cash flow analysis', 'retirement modeling', 'education funding gap', 'plan delivery', 'savings rate', 'plan update trigger', or 'is my client on track'.
npx skillsauth add joellewis/finance_skills financial-planning-workflowInstall 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.
Guide the complete advisor workflow for assembling and delivering a comprehensive financial plan. This skill orchestrates the planning engagement from initial client data gathering through cash flow projections, retirement modeling, goal-specific analysis, scenario modeling, and prioritized recommendations. It covers the sequencing, dependencies, and decision points at each stage of plan construction — teaching Claude how to coordinate multi-goal financial plans rather than individual calculations, which are handled by dedicated quantitative skills.
10 — Advisory Practice (Front Office)
prospective
The financial plan begins with a structured intake that captures the client's complete financial picture. Incomplete data leads to unreliable projections and missed planning opportunities. The advisor should collect the following categories systematically before any analysis begins:
Household demographics — ages, marital status, dependents (ages and expected years of financial support), health status and family longevity history, employment status and expected retirement dates, state of residence (for state tax modeling).
Income and benefits — gross salary, bonuses, commissions, self-employment income, rental income, pension details (defined benefit formula, COLA, survivor options), Social Security statements for both spouses, deferred compensation schedules, stock option or RSU vesting schedules.
Expense analysis — fixed obligations (mortgage, loan payments, insurance premiums, property taxes), discretionary spending (travel, dining, entertainment), irregular expenses (home maintenance, vehicle replacement, medical), and expected changes (mortgage payoff date, child-related expenses aging out, healthcare costs in retirement).
Assets and accounts — taxable brokerage accounts, traditional and Roth IRAs, 401(k)/403(b) balances and contribution rates, HSAs, 529 plans, real estate (primary residence and investment properties with basis information), business ownership interests, cash reserves, and any concentrated stock positions.
Liabilities — mortgage balance, rate, and remaining term; student loans; auto loans; credit card balances; HELOCs; any contingent liabilities (co-signed loans, pending legal obligations).
Insurance — life insurance (term and permanent, face amounts, premiums, cash values), disability coverage (employer-provided and individual, benefit amounts, elimination periods, own-occupation vs any-occupation), long-term care coverage, umbrella liability, and health insurance details.
Estate documents — wills, trusts, powers of attorney, healthcare directives, beneficiary designations on all accounts and insurance policies, any existing irrevocable trusts or family limited partnerships.
Tax returns — most recent two to three years of federal and state returns, revealing effective tax rates, deduction patterns, AMT exposure, capital gain/loss carryforwards, and charitable giving history.
Cash flow is the engine of the financial plan. Before projecting any future goals, the advisor must establish a reliable baseline of current income, spending, and savings. Key steps include:
Retirement is typically the largest and most complex goal in the plan. The analysis has two phases: accumulation (saving and investing toward retirement) and distribution (drawing down assets to fund retirement spending).
Accumulation phase — project account balances forward using current savings rates, employer matches, expected returns by asset class, and tax-deferred growth. Model the impact of increasing savings rates (e.g., saving all future raises). Account for expected lump-sum events (inheritance, home downsizing, stock option exercises).
Social Security optimization — model claiming at 62, full retirement age, and 70 for both spouses. The optimal strategy depends on relative earnings, age difference, health, and other income sources. Delayed claiming increases the inflation-adjusted guaranteed income floor. For married couples, evaluate the restricted application and survivor benefit interaction.
Pension integration — if the client has a defined benefit pension, model the lump-sum vs annuity decision, survivor benefit election (joint-and-survivor percentages), and COLA provisions. The pension's guaranteed income reduces the withdrawal burden on the investment portfolio.
Sustainable withdrawal strategy — establish the initial withdrawal rate (commonly benchmarked against 4% but adjusted for plan duration, asset allocation, and flexibility). Model withdrawal sequencing across account types: draw from taxable first to allow tax-deferred accounts to compound, but consider Roth conversion opportunities in low-income years between retirement and Social Security/RMD onset.
Monte Carlo simulation — run probability-of-success analysis using 1,000+ randomized return sequences to stress-test the plan against sequence-of-returns risk. A plan with 80-90% success probability is generally considered funded. Below 70% requires material adjustment. Present results as a confidence range rather than a single deterministic projection.
Longevity risk — plan to age 90-95 for at least one spouse. Use mortality tables adjusted for client health and family history. Discuss the asymmetry: running out of money is catastrophic, while dying with a surplus is merely suboptimal.
For clients with children or grandchildren, education funding is modeled as a specific goal with its own timeline and inflation rate:
The financial plan must address wealth transfer, even for clients who do not consider themselves wealthy. Key elements:
Assess whether the client's insurance coverage matches the risks identified in the plan:
A single deterministic projection creates false precision. The plan should present at least three scenarios to frame the range of outcomes:
Additionally, model specific what-if questions the client raises: "What if I retire at 58 instead of 62?" "What if we move to a no-income-tax state?" "What if we pay for private school?" Each what-if should show the impact on retirement success probability and the trade-off with other goals.
The output of the planning process is a ranked list of action items. Prioritization follows this framework:
Each recommendation should include a specific action, responsible party, target completion date, and the quantified impact on the plan (e.g., "Increasing 401k contribution from 6% to 10% improves retirement success probability from 72% to 84%").
The plan presentation meeting converts analysis into client commitment. Effective delivery requires:
A financial plan is a living document. Establish triggers for plan updates:
At each update, re-run the probability-of-success analysis and compare to the prior review. Track whether the plan is improving, stable, or deteriorating, and adjust recommendations accordingly.
Scenario: Michael (44) and Sarah (42) are married with two children (ages 10 and 7). Combined gross income is $285,000. They have $620,000 in retirement accounts (mix of 401k and Roth IRA), $85,000 in 529 plans, a $480,000 mortgage at 3.25% with 22 years remaining, and $45,000 in taxable savings. Both have employer-sponsored health and disability insurance. They have basic term life policies ($500,000 each) and outdated wills drafted before their second child was born. They want to retire at 62, send both children to four-year public universities, and pay off the mortgage before retirement.
Planning Elements:
Analysis: The plan reveals competing demands on a finite surplus. Prioritized recommendations: (1) Update wills and beneficiary designations immediately — no cost, high risk reduction. (2) Increase term life coverage to recommended levels — adds approximately $120/month. (3) Increase 401(k) contributions by 2% of salary each ($475/month combined) to close the retirement gap — improves Monte Carlo success to 86%. (4) Maintain current 529 contributions but do not accelerate — the education gap can be bridged with cash flow from reduced expenses as children age and from the surplus freed when the mortgage reaches its natural payoff date (age 66). (5) Do not accelerate mortgage payoff — the 3.25% rate is below expected portfolio returns, and the capital is more productive in retirement accounts. The mortgage payoff falls after the target retirement date, but the remaining balance ($68,000) is manageable from retirement assets. Present this trade-off explicitly so the client can make an informed decision about the emotional value of entering retirement debt-free versus the financial efficiency of maintaining the mortgage.
Scenario: Patricia (58) is a single corporate attorney earning $210,000 annually. She has $1.4M in her 401(k), $180,000 in a Roth IRA, $95,000 in a taxable brokerage account, and owns her home outright (valued at $550,000). She wants to retire at 62 but is concerned about healthcare costs before Medicare eligibility at 65. Her Social Security benefit at 62 is $2,100/month; at 67 it is $3,100/month; at 70 it is $3,850/month. She has no pension, no dependents, and her estate plan leaves everything to a sibling and two nieces. She has employer-provided life and disability insurance that terminates at retirement.
Planning Elements:
Analysis: Prioritized recommendations: (1) Build a two-year cash reserve ($175,000) in the taxable account before retirement to fund the first two years of expenses without forced portfolio withdrawals in a potential down market — begin redirecting current savings surplus now. (2) Retire at 62 as planned — the numbers support it. (3) Delay Social Security to age 70 — the guaranteed income increase is the most efficient longevity insurance available, and her portfolio can sustain the interim withdrawals. (4) Execute systematic Roth conversions of $80,000-$100,000 annually from ages 62-67, filling the 22% and 24% tax brackets. This front-loads tax liability but reduces lifetime taxes and eliminates RMD pressure. (5) Manage ACA income carefully — keep MAGI below the subsidy cliff during ages 62-65 by coordinating Roth conversion amounts with healthcare premium optimization. (6) Simplify the estate plan — current documents are adequate, but consider adding a revocable living trust to avoid probate on the real estate and ensure seamless transfer to the sibling and nieces.
Scenario: David (47) recently finalized a divorce. He received $310,000 from the division of retirement accounts (rolled into an IRA), $120,000 in a taxable account, and retains the family home (valued at $425,000 with a $280,000 mortgage at 4.75%). He has primary custody of two children (ages 12 and 14) and receives $2,400/month in child support until each child turns 18. His salary is $135,000. He has a $250,000 term life policy from his employer but no individual coverage. His previous financial plan was built around dual incomes and is now obsolete. He has no updated will or estate documents.
Planning Elements:
Analysis: This plan requires honest conversation about trade-offs and a phased approach. Prioritized recommendations: (1) Update all beneficiary designations and estate documents within 30 days — this is the highest-urgency item. Name a guardian for the children. Remove the former spouse from all accounts. (2) Obtain individual term life insurance ($750,000, 15-year term) immediately while David is healthy — estimated cost $65/month. (3) Increase 401(k) contribution to capture the full employer match if not already doing so. (4) Build a three-month emergency fund ($18,000) in a high-yield savings account — currently has no dedicated emergency reserve. (5) When child support for the older child ends (in 4 years), redirect $1,200/month to retirement savings — this single change improves Monte Carlo success to 68%. When the second child's support ends, redirect another $1,200/month — success probability reaches 79%. (6) Evaluate the housing decision at the 4-year mark when the older child leaves for college. At that point, downsizing becomes practical and can unlock equity for retirement savings. (7) Education funding is deferred — David should discuss expectations honestly with the children. Community college for two years followed by university transfer, merit scholarships, and modest student loans are realistic alternatives to full four-year residential funding. Retirement must take priority because it cannot be financed with debt. Present the full timeline showing how the plan improves materially as child-related expenses roll off over the next six years.
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
Maximize after-tax returns through strategic asset location, tax-loss harvesting, gain/loss management, and withdrawal sequencing. Use when the user asks about asset location, tax-loss harvesting, 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', 'wash-sale rule', 'tax drag', 'Roth vs Traditional', 'RMD planning', 'bracket stuffing', 'HIFO vs FIFO', or ask how to minimize taxes on investments.
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.