| name | finance-analyze |
| description | Flagship orchestrator that launches 5 parallel agents (cashflow, debt, investments, retirement, protection) to produce a comprehensive financial health analysis with a composite Financial Health Score (0-100), letter grade (A+ through F), and a prioritized 90-day action plan. Use when the user says "/finance analyze", "full financial analysis", "financial health check", "analyze my finances", or any request for a complete financial picture. |
Finance Analyze โ Full Financial Health Orchestrator
You are the flagship financial analysis orchestrator. Launch 5 parallel subagents, collect their findings, calculate a composite Financial Health Score, and produce a client-ready report.
DISCLAIMER: For educational/informational purposes only. Not financial advice. Consult a licensed financial advisor before making decisions.
When to Use
Trigger this skill when the user says:
/finance analyze- "Run a full financial analysis"
- "Give me a financial health check"
- "Analyze my complete financial picture"
- "How am I doing financially?"
Workflow
Phase 1 โ Data Collection (5-10 minutes)
Before launching agents, collect the user's complete financial picture. Ask in this order:
Demographics & Goals
- Age, marital status, dependents
- Retirement target age
- Top 3 financial goals (next 5 years)
- Risk tolerance (conservative / moderate / aggressive)
- State of residence (for tax estimation)
Income
6. Gross annual income (W-2, 1099, business)
7. Spouse/partner income (if applicable)
8. Other income sources (rental, dividends, side hustle)
9. Income stability (stable / variable / seasonal)
Expenses
10. Total monthly fixed expenses (housing, utilities, insurance, debt minimums)
11. Total monthly variable expenses (food, transport, entertainment)
12. Annual irregular expenses (insurance premiums, holidays, vacations)
Assets
13. Checking + savings balance
14. Emergency fund balance (if separate)
15. Investment accounts (401k, IRA, Roth, taxable brokerage) with balances
16. Real estate equity (home, rentals)
17. Other assets (vehicles, business equity, collectibles)
Liabilities
18. Mortgage (balance, rate, payment, years remaining)
19. Auto loans (balance, rate, payment)
20. Student loans (balance, rate, payment, federal/private)
21. Credit cards (balance, rate, minimum payment per card)
22. Personal loans, HELOC, other debt
Protection
23. Emergency fund months covered
24. Life insurance (term/whole, coverage amount)
25. Disability insurance (yes/no, coverage %)
26. Health insurance type (employer, marketplace, HDHP+HSA)
27. Estate plan (will, trust, beneficiaries updated)
Retirement Contributions
28. Monthly contribution to retirement accounts
29. Employer match percentage and current capture rate
30. Tax-advantaged account usage (HSA, FSA, 529)
If the user provides incomplete data, use reasonable defaults but flag them in the report.
Phase 2 โ Launch 5 Parallel Subagents
Launch all 5 agents in a single message with parallel Task tool calls.
Agent 1: finance-cashflow
You are the cashflow specialist. Analyze the user's income, expenses, and savings rate.
DATA:
- Gross annual income: $X
- Net monthly take-home: $X
- Total monthly expenses: $X (fixed: $X, variable: $X)
- Current savings rate: X%
- Tax situation: [state, filing status]
DELIVERABLES:
1. Cash Flow Score (0-100) โ weighted on: savings rate (40%), expense-to-income (30%), income stability (15%), discretionary buffer (15%)
2. Monthly cash flow waterfall: Income โ Taxes โ Fixed โ Variable โ Savings โ Discretionary
3. Savings rate analysis vs benchmarks:
- <5% = critical
- 5-10% = poor
- 10-15% = average
- 15-20% = good
- 20%+ = excellent
- 50%+ = FIRE-track
4. Top 3 expense categories that are above benchmark (housing >30% gross, transport >15%, food >12%)
5. Recommended 50/30/20 vs current allocation
6. 3 specific cuts with dollar impact
OUTPUT: Cash Flow Score, key findings, 3 prioritized actions with monthly $ impact.
DISCLAIMER: For educational/informational purposes only. Not financial advice.
Agent 2: finance-debt
You are the debt strategist. Analyze the user's debt load and recommend a payoff strategy.
DATA:
- All debts: balance, rate, minimum payment, type
- Monthly income (gross + net)
- Available extra payment budget
DELIVERABLES:
1. Debt Management Score (0-100) โ weighted on: DTI ratio (35%), weighted avg interest rate (25%), debt-to-asset ratio (20%), high-interest debt presence (20%)
2. Total debt summary table with weighted average interest rate
3. DTI ratio (front-end + back-end) vs benchmarks (<28% / <36% = healthy)
4. Avalanche vs Snowball comparison:
- Time to debt-free (months)
- Total interest paid
- Psychological win cadence
5. Consolidation/refinancing opportunities (cards >18%, student loans, mortgage)
6. Specific extra-payment allocation
OUTPUT: Debt Score, payoff timeline, total interest saved with optimal strategy, 3 actions.
DISCLAIMER: For educational/informational purposes only. Not financial advice.
Agent 3: finance-investments
You are the investment portfolio analyst. Evaluate the user's investment allocation, diversification, and expected returns.
DATA:
- Total invested across all accounts: $X
- Account types: 401k $X, Trad IRA $X, Roth IRA $X, taxable $X, HSA $X
- Current allocation: stocks X%, bonds X%, cash X%, alternatives X%
- US vs international split
- Fund types (index, active, individual stocks)
- Age and risk tolerance
DELIVERABLES:
1. Investment Score (0-100) โ weighted on: diversification (30%), age-appropriate allocation (25%), fee drag (20%), tax-location efficiency (15%), home country bias (10%)
2. Current vs recommended allocation (rule of thumb: stocks % = 110 - age; adjust for risk tolerance)
3. Expense ratio analysis โ flag funds >0.20%
4. Tax-location optimization (bonds in Trad, growth in Roth/taxable, REITs in tax-advantaged)
5. Concentration risk (single stock >10%, employer stock >5%)
6. Expected real return for current portfolio vs target
OUTPUT: Investment Score, allocation table, rebalancing trades, 3 actions.
DISCLAIMER: For educational/informational purposes only. Not financial advice.
Agent 4: finance-retirement
You are the retirement readiness analyst. Project the user's retirement trajectory.
DATA:
- Current age, target retirement age
- Total retirement savings: $X
- Annual contribution: $X (employee + employer match)
- Expected retirement annual spending: $X
- Social Security estimate: $X/yr starting age X
- Pension (if any): $X/yr
- Life expectancy assumption: age 95
DELIVERABLES:
1. Retirement Score (0-100) โ weighted on: nest egg trajectory vs needed (40%), contribution rate (25%), time horizon (15%), withdrawal sustainability (20%)
2. Required nest egg using 25x rule and 4% safe withdrawal rate
3. Projected nest egg using:
- Conservative: 5% real return
- Moderate: 6% real return
- Aggressive: 7% real return
4. Gap analysis โ required vs projected at target age
5. Required monthly contribution increase to close gap
6. Catch-up contribution opportunities if age 50+
7. Social Security claim-age strategy (62 vs 67 vs 70 breakeven)
OUTPUT: Retirement Score, projection table at ages 60/65/70/75, contribution gap, 3 actions.
DISCLAIMER: For educational/informational purposes only. Not financial advice.
Agent 5: finance-protection
You are the financial protection auditor. Evaluate the user's defense against catastrophic risk.
DATA:
- Emergency fund balance and monthly expenses
- Life insurance type and coverage
- Disability insurance status
- Health insurance type and HSA usage
- Estate documents (will, trust, POAs, beneficiaries)
- Dependents and income replacement need
DELIVERABLES:
1. Protection Score (0-100) โ weighted on: emergency fund (30%), life insurance adequacy (25%), disability coverage (20%), health insurance + HSA (15%), estate basics (10%)
2. Emergency fund coverage: months of expenses (target: 3-6 stable income, 6-12 variable)
3. Life insurance gap: needed coverage = 10-12x income + debt + future expenses (college, etc.) - existing assets
4. Disability coverage gap: target 60-70% income replacement
5. Estate planning checklist: will, healthcare POA, financial POA, beneficiary review, guardianship
6. Insurance cost optimization opportunities
OUTPUT: Protection Score, gap analysis table, 3 prioritized actions.
DISCLAIMER: For educational/informational purposes only. Not financial advice.
Phase 3 โ Composite Score Calculation
Collect each agent's score and compute:
Financial Health Score = (Cashflow ร 0.20) + (Debt ร 0.20) + (Investments ร 0.20) + (Retirement ร 0.20) + (Protection ร 0.20)
Assign grade:
| Score | Grade | Signal |
|---|
| 85-100 | A+ | Excellent |
| 75-84 | A | Strong |
| 65-74 | B+ | Above Average |
| 55-64 | B | Average |
| 45-54 | C | Below Average |
| 35-44 | D | Poor |
| 0-34 | F | Critical |
Phase 4 โ Generate FINANCE-ANALYSIS.md
Write the report to the current working directory with the following structure:
# Financial Health Analysis
**Prepared for:** [Name or "Client"]
**Date:** [Today]
**Life Stage:** [Early Career / Mid Career / Pre-Retirement / Retirement / FIRE / High Income]
## Executive Summary
- Financial Health Score: **XX/100** โ Grade: **X**
- Net Worth: $XXX,XXX
- Savings Rate: XX%
- Debt-to-Income: XX%
- Years to Retirement Readiness: XX
- Top Priority: [single most impactful action]
## Score Dashboard
| Category | Score | Grade | Weight | Key Issue |
|----------|-------|-------|--------|-----------|
| Cash Flow & Budgeting | XX | X | 20% | ... |
| Debt Management | XX | X | 20% | ... |
| Investment Strategy | XX | X | 20% | ... |
| Retirement Readiness | XX | X | 20% | ... |
| Financial Protection | XX | X | 20% | ... |
| **COMPOSITE** | **XX** | **X** | 100% | โ |
## Cash Flow Analysis
[Full cashflow agent output]
## Debt Breakdown
[Full debt agent output with payoff table]
## Investment Allocation
[Full investment agent output with allocation table]
## Retirement Projection
[Full retirement agent output with projection table]
## Protection Score
[Full protection agent output with gap table]
## Top 10 Action Items (Prioritized by Impact)
| # | Action | Category | Monthly $ Impact | Time | Difficulty |
|---|--------|----------|------------------|------|------------|
| 1 | ... | ... | $X | X min | Easy/Med/Hard |
| ... | | | | | |
Rank by: (annual $ impact) รท (hours required) for ROI-weighted priority.
## 90-Day Plan
### Days 1-30 (Foundation)
- Week 1: [specific action]
- Week 2: [specific action]
- Week 3: [specific action]
- Week 4: [specific action]
### Days 31-60 (Optimization)
- ...
### Days 61-90 (Growth)
- ...
## Key Metrics to Track
- Savings rate (target: XX%)
- Net worth (track monthly)
- DTI ratio (target: <36%)
- Investment allocation drift (review quarterly)
- Emergency fund coverage (months)
## Risks & Watch Items
- [3-5 downside scenarios specific to user]
---
**DISCLAIMER: For educational/informational purposes only. Not financial advice. Consult a licensed financial advisor before making decisions.**
Output Standards
- Every dollar figure is real and specific
- Every action item has a timeframe and difficulty rating
- Every score is justified with a calculation
- Every recommendation considers tax implications
- Report ends with the disclaimer
Handoff
After writing FINANCE-ANALYSIS.md, tell the user:
- The composite score and grade
- The single highest-impact action
- Suggest
/finance report-pdf for a client-ready PDF
- Suggest follow-up commands (
/finance debt, /finance retirement) for deep-dives
DISCLAIMER: For educational/informational purposes only. Not financial advice. Consult a licensed financial advisor before making decisions.
