Orchestrate the advisor workflow for assembling and delivering a comprehensive financial plan — data gathering, cash flow analysis, retirement modeling, Monte Carlo analysis, Roth conversion and withdrawal sequencing, Social Security claiming strategy, education and estate goals, scenario modeling, and prioritized recommendations. Use when the user asks about building a financial plan, structuring a planning engagement, retirement or Social Security modeling, Roth conversion strategy, scenario analysis, prioritizing competing recommendations, preparing a plan presentation, or deciding when a plan needs updating. Also trigger on 'comprehensive financial plan', 'discovery meeting', 'retirement modeling', 'Monte Carlo', 'Roth conversion', 'Social Security claiming', 'savings rate', or 'is my client on track'. For planning-tool data flows, capital market assumption governance, or connecting planning software to CRM/PMS, use financial-planning-integration instead.
npx skills add https://github.com/JoelLewis/finance_skills --skill financial-planning-workflow
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.
This skill provides an advanced financial modeling suite with DCF analysis, sensitivity testing, Monte Carlo simulations, and scenario planning for investment decisions
This skill retrieves upcoming earnings announcements for US stocks using the Financial Modeling Prep (FMP) API. Use this when the user requests earnings calendar data, wants to know which companies are reporting earnings in the upcoming week, or needs a weekly earnings review. The skill focuses on mid-cap and above companies (over $2B market cap) that have significant market impact, organizing the data by date and timing in a clean markdown table format. Supports multiple environments (CLI, Desktop, Web) with flexible API key management.
This skill should be used when analyzing recent market-moving news events and their impact on equity markets and commodities. Use this skill when the user requests analysis of major financial news from the past 10 days, wants to understand market reactions to monetary policy decisions (FOMC, ECB, BOJ), needs assessment of geopolitical events' impact on commodities, or requires comprehensive review of earnings announcements from mega-cap stocks. The skill automatically collects news using WebSearch/WebFetch tools and produces impact-ranked analysis reports. All analysis thinking and output are conducted in English.
Screen post-earnings gap-up stocks for PEAD (Post-Earnings Announcement Drift) patterns. Analyzes weekly candle formation to detect red candle pullbacks and breakout signals. Supports two input modes - FMP earnings calendar (Mode A) or earnings-trade-analyzer JSON output (Mode B). Use when user asks about PEAD screening, post-earnings drift, earnings gap follow-through, red candle breakout patterns, or weekly earnings momentum setups.
Plan a sprint — scope work, estimate capacity, set goals, and draft a sprint plan. Use when kicking off a new sprint, sizing a backlog against team availability (accounting for PTO and meetings), deciding what's P0 vs. stretch, or handling carryover from the last sprint.
Provide US dividend tax and account-location workflow for Kanchi-style income portfolios. Use when users ask about qualified vs ordinary dividends, 1099-DIV interpretation, REIT/BDC distribution treatment, holding-period checks, or taxable-vs-IRA account placement decisions for dividend assets.
Business fundamentals for indie app developers — LLC/entity setup, taxes, Apple Small Business Program, revenue tracking, hiring contractors, and financial planning for sustainability. Use when user asks about business setup, tax implications, hiring, or financial planning for their app business.
Inventory management for TikTok Shop — demand forecasting, viral stock planning, FBT optimization
Take joellewis/financial-planning-workflow from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.