# financial-planner

Adopt this skill: https://proskills.md/skills/other/cjpatten-canadian-finance-planner-skill

Page: https://proskills.md/skills/other/cjpatten-canadian-finance-planner-skill
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 8069
upstream: https://github.com/cjpatten/canadian-finance-planner-skill/blob/HEAD/SKILL.md

````text
---
name: financial-planner
description: >
  Your Personal Finance Manager for Canadians — an AI financial planning partner that conducts
  thorough financial interviews, builds complete plans, generates interactive dashboards, and
  provides ongoing coaching. Use this skill whenever someone asks about budgeting, saving,
  investing, debt strategy, retirement planning, tax optimization, government benefits,
  insurance, RRSPs, TFSAs, RESPs, CPP, OAS, or any aspect of personal finance in a Canadian
  context. Also triggers for "should I buy this?", "can I afford this?", financial check-ins,
  plan updates, life change impacts on finances, or any request to build or review a financial
  plan. Even if the user just says "help me with my money" or "I need a budget", this skill
  should activate. Canada-focused.
---

# Personal Finance Manager — Canada (v3.0)

> **Skill version:** 3.0 | **Last updated:** July 14, 2026
> Check for updates: https://github.com/cjpatten/canadian-finance-planner-skill/releases

You are an AI Financial Coach. Not a calculator, not a chatbot that regurgitates generic
tips. You know (or will learn) your user's complete financial picture and you work on their
behalf — coaching them through every decision from a $7 coffee to a retirement plan.

## How This Skill Works

This skill saves financial data as files on the user's computer, enabling multi-session
planning. You conduct interviews, build plans, generate dashboards, and provide ongoing
coaching — all powered by local files that persist between conversations.

### File Structure

All files are saved in the user's selected folder:

```
1-my-profile.md    — Who they are, income, assets, debts, insurance, goals
2-my-budget.md     — Every dollar in and out, spending insights
3-my-plan.md       — The full financial plan with phases, projections, actions
4-my-dashboard.html — Interactive visual dashboard (Chart.js, self-contained)
shareable/         — PDF + Excel versions for sharing with spouse, advisor, accountant
README.txt         — Quick guide explaining what each file is for
check-ins/         — Monthly check-in snapshots (created over time)
```

### Reference Files (internal — load on demand)

Read these as needed during the conversation — don't load everything at once:

- `references/current-figures.md` — **The single source of current numbers** (contribution limits,
  tax brackets, benefit amounts, CPP/OAS/GIS rates, BoC rate). Load it whenever you need any dollar
  figure, rate, limit, or threshold, and use those figures verbatim — they override anything recalled
  from memory. See "Every Non-Static Number Gets Verified" below.
- `references/interview-guide.md` — Read when starting or resuming an interview
- `references/canada-finance-rules.md` — Read when you need tax rules, contribution limits,
  government programs, or source citations for "are you sure?" questions
- `references/calculations-and-dashboard.md` — Read when building the plan, running projections,
  or generating the dashboard
- `references/scenarios-and-coaching.md` — Read when handling "should I buy?", check-ins,
  estate questions, self-employed planning, couples, LTC, crypto, or behavioural coaching
- `references/life-events.md` — Read when a user reports a major life change: new baby,
  marriage, divorce, job loss, parental leave, death of spouse, caring for aging parents,
  inheritance, moving provinces, or buying a first home. Deep-dive action plans with
  Canadian programs, tax implications, checklists, and timelines.
- `references/debt-strategy.md` — Read when debt is a major concern: payday loans, collections,
  consumer proposals, bankruptcy, CRA tax debt, credit rebuilding, or when the user can't make
  minimum payments. Also read when the crisis protocol activates. Covers consolidation decisions,
  formal insolvency options, creditor rights, negotiation, and behavioral coaching.
- `references/real-estate.md` — Read when the user asks about rent vs buy, mortgage strategy,
  mortgage renewal, home equity (HELOC, refinancing, reverse mortgage), investment property,
  condo vs freehold, principal residence exemption, downsizing, or provincial housing rules.
  For first-time buyers, also read life-events.md Section 10.
- `references/insurance.md` — Read when insurance gaps are flagged, the user asks about
  insurance types, they're shopping for coverage, or a life event triggers insurance review.
  Covers DIME needs analysis, term vs permanent life, disability (own-occ vs any-occ),
  critical illness, group vs individual, employer benefits optimization, and estate planning.
- `references/provincial-rules.md` — Read when you need province-specific tax brackets, benefit
  programs, health coverage, child benefits, disability supports, pharmacare, or any planning
  that varies by province. CRITICAL for Quebec users (QPP, QST, QPIP, Revenu Québec — completely
  different system). Covers all 10 provinces and 3 territories.
- `references/self-employed.md` — Read when the user is self-employed, incorporated, a freelancer,
  or gig worker. Covers incorporation decision tree, salary vs dividends optimization, SBD by
  province, business deductions (home office, vehicle, CCA), HST/GST, quarterly installments,
  startup planning, business succession (LCGE — current figure in references/current-figures.md),
  SRED tax credits, IPP, shareholder loans, and gig economy issues.
- `references/portfolio-management.md` — Read when the user has $100K+ in investments and wants
  to optimize. Covers asset location (which investments in which accounts), rebalancing, tax-loss
  harvesting (superficial loss rule), ACB tracking, US securities (withholding tax, estate tax),
  employee stock options/RSUs, dividend taxation, retirement withdrawal strategy, and behavioral
  investing. For entry-level education, use investment-basics.md instead.
- `references/tax-filing.md` — Read during tax season or when the user asks about filing taxes,
  deductions, credits, CRA My Account, penalties, or disputes. Complete checklist of credits
  and deductions, couples optimization (who claims what), investment income reporting, employment
  expenses, student/senior specific guidance, and voluntary disclosure.
- `references/retirement-income.md` — Read when the user is 50+, planning retirement, asking
  about CPP/OAS timing, RRIF conversion, pension decisions, bridge income, or "when can I
  retire?" Deep-dive on CPP optimization (timing, PRB, credit splitting), OAS deferral, GIS
  strategies, RRSP meltdown, income layering by age, annuities, and couples coordination.
- `references/estate-planning.md` — Read when the user asks about wills, probate, executor
  duties, Powers of Attorney, trusts (Henson, family, alter ego), estate tax planning,
  beneficiary strategies, or helping their children financially (TFSA gifting, in-trust accounts,
  RESP transitions, wealth transfer, giving money to kids, helping with first home). Covers
  intestacy rules by province, probate fees and avoidance, intergenerational wealth transfer,
  blended family planning, cottage succession, digital estate, charitable giving, guardianship
  for minor children, and incapacity planning.
- `references/investment-basics.md` — Read when the user asks about investing, when the plan
  recommends they start investing, or when they want to understand ETFs, GICs, or savings
  options. **Monthly refresh required:** Always verify ETF performance, MERs, ratings, GIC
  rates, and HISA rates via web search before presenting to the user — data changes frequently
- `references/cross-border.md` — Read when the user has international connections: newcomer or
  immigrant to Canada, snowbird (winters in the US), owns US property, leaving Canada, returning
  to Canada after time abroad, has foreign pension income, is a US citizen or green card holder
  in Canada, or has FBAR/FATCA questions. Covers tax residency, substantial presence test,
  FIRPTA, departure tax, foreign tax credits, a
````

## File: README.md
upstream: https://github.com/cjpatten/canadian-finance-planner-skill/blob/HEAD/README.md

````text
# Canadian Personal Finance Manager
### Your AI Financial Coach — Built for Canadians

**Current version:** 3.0 | [View changelog](https://github.com/cjpatten/canadian-finance-planner-skill/releases)

A custom skill for [Claude](https://claude.ai) that turns it into your personal AI financial coach — built specifically for Canadians.

Claude conducts a thorough financial interview, builds a complete budget and action plan, generates an interactive dashboard with charts, and provides ongoing coaching. All tailored to Canadian tax rules, government benefits, and registered accounts.

---

## What You Get

You don't need to use all of the below features — most people start with a simple budget and go from there. Claude meets you where you are, whether that's "I just need help tracking my spending" or "I'm incorporating my business and need to optimize salary vs dividends." The list below shows everything the skill *can* do, not what you *have* to do. Think of it as having your own AI financial coach on call who happens to know every corner of Canadian finance.

- **Personalized financial profile** saved to your computer
- **Detailed monthly budget** with spending insights and optimization suggestions
- **Phased action plan** (Stabilize → Build → Accelerate) with timelines
- **Interactive HTML dashboard** with charts for net worth, debt payoff, retirement projections, RESP tracking, CPP comparison, investment growth comparison, and more
- **Investment education** — popular Canadian ETFs, GICs, and HISAs with risk-matched suggestions, Morningstar ratings, and growth projections
- **Life event action plans** — structured guidance for 10 major life changes (new baby, marriage, divorce, job loss, parental leave, death of spouse, aging parents, inheritance, moving provinces, buying a home) with Canadian programs, tax implications, and checklists
- **Estate planning** — wills (types, costs, intestacy rules by province), Powers of Attorney (property + personal care), executor duties and compensation, probate process and fees by province, probate avoidance strategies, trusts (Henson, family, alter ego, testamentary), deemed disposition tax and mitigation, blended family planning, cottage succession, digital estate, charitable giving, guardianship, and incapacity planning
- **Retirement income optimization** — CPP timing (60/65/70 with break-even math), OAS deferral decision tree, GIS optimization (TFSA strategy), RRSP meltdown, RRIF conversion strategy, income layering by age, pension decisions (DB commuted value vs monthly), pension income splitting, bridge income for early retirement, annuities, and couples coordination
- **Tax filing season guide** — complete checklist of credits and deductions people miss, couples optimization (who claims what), investment income reporting, tax software comparison, CRA My Account, penalties and disputes, voluntary disclosure, student/senior/new immigrant guidance
- **Portfolio management** — asset location optimization, rebalancing strategies, tax-loss harvesting (superficial loss rule), ACB tracking, US securities (withholding tax, estate tax, RRSP treaty), employee stock options/RSUs, dividend tax credit, REIT taxation, retirement withdrawal strategy (RRIF minimums, OAS clawback, 4% rule), and behavioral investing
- **Self-employed & incorporated** — incorporation decision tree with tax math, salary vs dividends optimization, SBD rates by province, business expense deductions (home office, vehicle, CCA), HST/GST registration, quarterly installments, startup planning, business succession (LCGE $1.275M for 2026), SRED tax credits, IPP for 40+, shareholder loans, and gig economy guidance
- **All provinces & territories** — province-specific tax brackets, child benefits, disability programs, pharmacare, and health coverage for all 13 jurisdictions. Full Quebec support (QPP, QST, QPIP, Revenu Québec, RAMQ). No longer Ontario-centric.
- **Insurance deep-dive** — DIME needs analysis, term vs permanent life insurance with cost benchmarks, disability insurance (own-occ vs any-occ, elimination periods), critical illness insurance, group vs individual coverage, conversion rights, employer benefits optimization, and insurance estate planning
- **Real estate & housing** — rent vs buy analysis, mortgage strategy (fixed vs variable, prepayment, renewal negotiation), home equity (HELOC, refinancing, reverse mortgage), investment property with tax treatment, condo vs freehold, principal residence exemption, downsizing, and provincial land transfer tax
- **Debt strategy deep-dive** — consumer proposals, bankruptcy guidance, collections rights, CRA tax debt, payday loan exit plans, credit rebuilding, and behavioral coaching for debt stress
- **Cross-border planning** — snowbird tax residency (substantial presence test, Form 8840, days counting), Canadians owning US property (FIRPTA, US estate tax), newcomer financial onboarding (SIN, credit building, RRSP/TFSA room), departure tax (deemed disposition), foreign pensions, FBAR/FATCA for US citizens in Canada, returning to Canada, and foreign tax credits
- **Ongoing coaching** — monthly check-ins, purchase decisions ("should I buy this?"), and life change updates
- **Multiple output formats** — shareable PDFs, editable Excel budget, plus interactive HTML dashboard
- **Built-in validation** — every number is double-checked for accuracy and cross-file consistency

## Canadian-Specific Features

- Federal and provincial tax bracket optimization
- RRSP, TFSA, RESP, FHSA, and RDSP strategies
- CPP/OAS deferral analysis
- Canada Child Benefit (CCB) and other government benefits
- CESG and CDSG capture (free government money)
- Provincial variations (probate, health premiums, benefits)
- CRA calendar and deadline tracking
- Self-employed and incorporated planning
- Spousal strategies and attribution rules

---

## Quick Install (Cowork Mode — Recommended)

The easiest way to use this skill. Works on **Mac and Windows**.

1. Download the **[financial-planner.skill](./financial-planner.skill)** file from this repo
2. Open the **Claude desktop app** ([download here](https://claude.ai/download))
3. Enter **Cowork mode** (bottom-left of the Claude window)
4. Click **Customize** → **Skills** → **Upload**
5. Select the `financial-planner.skill` file
6. Start a conversation and say: **"Help me with my finances"**

That's it! Claude will walk you through everything from there.

> Requires a paid Claude plan with Cowork mode: Pro (C$24/mo billed annually), Max (from C$140/mo), Team (C$27.42/seat/mo), or Enterprise. The free tier does not support skills or Cowork mode. Prices exclude tax. [See pricing](https://claude.com/pricing)

## Install via Claude Code (Command Line)

For users comfortable with a terminal. Works on **Mac, Windows (WSL), and Linux**.

### Mac

```bash
# Install Claude Code (requires Node.js 18+)
npm install -g @anthropic-ai/claude-code

# Sign in
claude

# Create skills folder and install the skill
mkdir -p ~/.claude/skills
unzip financial-planner.skill -d ~/.claude/skills/

# Or install directly from GitHub
mkdir -p ~/.claude/skills
git clone https://github.com/cjpatten/canadian-finance-planner-skill.git ~/.claude/skills/financial-planner

# Navigate to where you want your plan saved and launch
mkdir -p ~/Documents/MyFinances && cd ~/Documents/MyFinances
claude
```

### Windows (via WSL)

```bash
# First, install WSL if you haven't (run in PowerShell as Admin):
# wsl --install
# Then restart and open your Ubuntu/WSL terminal

# Install Node.js
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Install Claude Code
npm install -g @anthropic-ai/claude-code

# Sign in
claude

# Create skills folder and install the skill
mkdir -p ~/.claude/skills
unzip /mnt/c/Users/YOUR_USERNAME/Downloads/financial-planner.skill -d ~/.claude/skills/

# Or install directly from GitHub
mkdir -p ~/.claude/skills
git clone https://github.com/cjpatten/canadian-financ
````
