eliasoulkadi/shokunin/finance

Claude Code and agent skill by eliasoulkadi/shokunin

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Personal finance planning — 5-pillar framework (cash flow, net worth, debt, emergency fund, investing), tax optimization, insurance review, retirement planning (FIRE, 4% rule, Mega Backdoor Roth), and document retention.

Install

npx vskill@latest install eliasoulkadi/shokunin/finance

SKILL.md

Disclaimer: Educational financial planning information. Not professional financial advice.


Workflow

Follow in order. Skip pillars already covered.

1. Assess Cash Flow
  1. Calculate real monthly income (take-home after taxes, insurance, retirement)
  2. Track expenses for 30 days
  3. Classify into Needs (50%), Wants (30%), Savings (20%)
  4. Identify surplus or deficit
2. Calculate Net Worth
  1. List all assets (cash, investments, property, retirement accounts)
  2. List all liabilities (credit cards, loans, mortgage, student debt)
  3. Net Worth = Total Assets - Total Liabilities
  4. Track monthly — direction matters more than the number
3. Eliminate High-Interest Debt
  1. List all debts with balance, rate, minimum payment
  2. Choose avalanche (highest rate first) or snowball (smallest balance first)
  3. Attack with surplus from cash flow
  4. Debt is emergency if total > 6 months income OR rate > 10%
4. Build Emergency Fund
  1. Phase 1: $1,000 or 1 month (starter)
  2. Phase 2: 3-6 months of essential expenses (full)
  3. Phase 3: 6-12 months (conservative / irregular income)
  4. Keep in HYSA only. Never invest it.
5. Invest for Retirement
  1. 401(k) up to employer match → free money
  2. HSA (if eligible) → triple tax-advantaged
  3. IRA (Roth or Traditional) → $7,000/yr ($8,000 if 50+)
  4. 401(k) up to max ($23,500)
  5. Taxable brokerage → no limits

5-Pillar Framework

1. Cash Flow → Income - Expenses = Surplus
2. Net Worth → Assets - Liabilities = Net Worth
3. Debt → Avalanche or Snowball
4. Emergency → 3-6 months essential expenses in HYSA
5. Invest → Tax-advantaged accounts first

Pillar 1: Budgeting

50/30/20 Rule
Category%Includes
Needs50%Housing, utilities, groceries, insurance, minimum debt, transport
Wants30%Dining, entertainment, subscriptions, travel, shopping
Savings20%Emergency fund, retirement, investments, extra debt
Budgeting Methods
MethodBest for
50/30/20Beginners
Zero-basedDetail-oriented
EnvelopeOverspenders
Pay-yourself-firstSavers

Pillar 2: Net Worth

  • Track monthly via spreadsheet or app
  • Direction > absolute number
  • Milestones: $0 → 3 months expenses → 1x income → 10x income

Pillar 3: Debt Payoff

StrategyApproachBest for
AvalancheExtra to highest interest rateMathematically optimal
SnowballExtra to smallest balancePsychological wins
Debt is emergency if: total > 6 months income OR interest rate > 10%

Pillar 4: Emergency Fund

PhaseAmountWhen
Starter$1,000 or 1 monthWhile paying off debt
Full3-6 months essential expensesAfter debt free
Conservative6-12 monthsIrregular income, self-employed

Where: High-yield savings account (HYSA). Never invested.

Pillar 5: Investing & Retirement

Account Contribution Hierarchy
  1. 401(k) up to employer match → free money, do this first
  2. HSA (if eligible) → triple tax-advantaged
  3. IRA (Roth or Traditional) → $7,000/yr ($8,000 if 50+)
  4. 401(k) up to max → $23,500/yr
  5. Taxable brokerage → no limits, less tax-advantaged
2026 Contribution Limits
AccountLimit
401(k) elective deferral$23,500 ($31,000 with catch-up 50+)
IRA$7,000 ($8,000 catch-up 50+)
HSA (individual)$4,300
HSA (family)$8,550
HSA catch-up (55+)$1,000
Mega Backdoor Roth (after-tax 401k)$69,000 total (incl. employer)
3-Fund Portfolio
- US total market (VTI / FSKAX): 60-70%
- International (VXUS): 20-30%
- US bonds (BND / FXNAX): 10-20% (age - 20 = bond %)

Target expense ratio: 0.03-0.07%. Rebalance annually.

Savings Benchmarks (Fidelity)
Age3035404550556065
1x salary2x3x4x5x6x7x10x
Withdrawal Rules
  • 4% rule (25x annual expenses) — traditional retirement
  • 3-3.5% for early retirement / longer horizons
  • RMDs start at age 73 (SECURE 2.0)
Mega Backdoor Roth
  1. Check if 401(k) allows after-tax contributions + in-plan Roth rollover
  2. Contribute up to $69,000 - $23,500 (elective) - employer match = after-tax capacity
  3. Request in-plan Roth rollover (automatic if plan supports it)
  4. Growth on after-tax is taxable if not rolled over promptly
Pro-rata rule does NOT apply to 401(k) after-tax → Roth conversions
Backdoor Roth IRA
  1. Contribute $7,000 to Traditional IRA (non-deductible)
  2. Convert to Roth IRA
  3. Pay tax only on earnings between contribution and conversion
Pro-rata rule: if you have other Traditional IRA balances, conversion is partially taxable
Fix: roll Trad IRA into 401(k) before converting

Tax Optimization

StrategyImpact
Max HSA ($4,300 / $8,550)Triple tax-free
Max Trad IRA deductionReduces AGI
Tax-loss harvestingOffset gains + $3,000/yr income
Mega Backdoor RothAfter-tax → Roth, up to $69,000
Health insurance (self-employed)Above-the-line deduction
2026 Standard Deduction (estimated)
  • Single: ~$15,000
  • Married filing jointly: ~$30,000
  • Head of household: ~$22,500

Itemize only if deductions exceed standard.


Insurance Check

TypeWhat to check
HealthDeductible, OOP max, HSA eligibility
Auto/HomeLiability ≥ $300K, umbrella if NW > $500K
LifeTerm only (never whole/universal). 10-12x income, 20-30yr term
DisabilityOwn-occupation, covers 60% income

Financial Document Retention

DocumentKeep
Tax returns + supporting docs7 years
W-2sUntil Social Security claimed
Bank/credit card statements1 year (unless tax-related)
Investment statementsUntil sold
Real estate closingUntil sold + 7 years
Estate docs (will, trust)Permanent
Loan documentsUntil paid + 7 years

Error Handling

ScenarioCauseMitigation
Negative cash flowBudget > incomeCut wants first, then needs; increase income
Emergency fund not growingNo budget surplusRevisit 50/30/20; automate transfers on payday
Debt increasing despite paymentsInterest outpaces principalAvalanche to highest rate; consider consolidation
Investment losses panicMarket volatilityRebalance annually, not on news; stay the course
Backdoor Roth pro-rata taxTraditional IRA balance existsRoll Trad IRA into 401(k) before converting
HSA ineligibleHDHP not satisfiedVerify HDHP minimums; switch plans at open enrollment
Tax bill surpriseUnderwithheldAdjust W-4; make estimated quarterly payments

Production Checklist

  • [ ] Income: calculated take-home (not gross)
  • [ ] Expenses: tracked for ≥ 30 days
  • [ ] 50/30/20: verified categories add up
  • [ ] Net worth: baseline recorded
  • [ ] Debt: all debts listed with rates and minimums
  • [ ] Strategy: avalanche or snowball chosen
  • [ ] Emergency fund: at least starter phase in HYSA
  • [ ] Retirement: 401(k) match captured
  • [ ] HSA: maxed if eligible
  • [ ] IRA: funded for current year
  • [ ] Asset allocation: 3-fund portfolio set
  • [ ] Insurance: life, health, disability, auto/home reviewed
  • [ ] Tax: withholding checked, prior year return reviewed
  • [ ] Documents: retention schedule applied

Anti-Patterns

Anti-patternFix
Budgeting every dollar without bufferLeave 5-10% buffer for variable expenses
Investing before emergency fund3-6 months in HYSA first
Whole life insuranceTerm life only. Invest the difference.
Timing the marketTime in market beats timing the market
No tax diversificationMix of pre-tax, Roth, and taxable accounts
Credit card debt as normalPay in full every month
No will / estate planEveryone needs will + healthcare directive + POA
Chasing returns / stock picking3-fund index portfolio, rebalance annually
Over-insuring (multiple whole life, annuities)Term life + umbrella only
Keeping too much cash (outside emergency fund)Invest surplus beyond 6-12 months expenses

Sources

  • IRS Publication for contribution limits 2025-2026
  • Fidelity retirement savings benchmarks
  • Bogleheads — 3-fund portfolio
  • SECURE 2.0 Act provisions
  • Kitces.com — Backdoor Roth, Mega Backdoor, tax strategies
  • Morningstar — SWR research

Checklist

  • [ ] Skill loads without errors in the AI agent
  • [ ] YAML frontmatter is valid (description, compatibility, audience)
  • [ ] Workflow section provides clear step-by-step instructions
  • [ ] Error handling section covers common failure modes
  • [ ] All referenced files (references/, scripts/, assets/) exist
  • [ ] Skill triggers correctly for intended use cases
  • [ ] No broken links or missing resources

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
101
Repository forks
12
7-day trend score
23

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 30 Jun 2026, 4 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/eliasoulkadi/shokunin/finance/badge)](https://verified-skill.com/skills/eliasoulkadi/shokunin/finance)

Something wrong with this skill or its page? Tell us.