tax-loss-review
Skill2 starsChanged 5 months agoMITView on GitHub
Canadian tax-loss harvesting review. Use when the user asks about tax-loss harvesting, "should I sell my losers?", capital losses, superficial loss rules, or year-end tax moves. Fetches loss candidates via aifolimizer MCP.
In this repository29 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- adversarial-researchSkill
- auto-rebalanceSkill
- cash-deploymentSkill
- daily-briefingSkill
- dividend-strategySkill
- earnings-analyzerSkill
- earnings-postmortemSkill
- employer-stockSkill
- health-checkSkill
- macro-impactSkill
- momentum-scannerSkill
- optimize-allocationSkill
- pead-trackerSkill
- perf-optimizerSkill
- portfolio-healthSkill
- portfolio-reviewSkill
- position-reviewSkill
- pre-trade-checkSkill
- profile-setupSkill
- risk-assessmentSkill
- sector-rotationSkill
- stock-analysisSkill
- stock-compareSkill
- top-trades-todaySkill
- trade-journalSkill
- trading-deskSkill
- weekly-mirrorSkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 4 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 10
Call mcp__aifolimizer__get_profile - identify which account holds each position (TFSA/RRSP losses NOT deductible)
- Very specific: line 11
Call mcp__aifolimizer__get_personal_context - use derived.marginal_tax_rate_pct + province to compute each loss's after-tax value (loss × …
- Very specific: line 12
Call mcp__aifolimizer__get_tax_loss_candidates with threshold_pct=-5.0 (or stricter -10.0 for clearer picks)
- Distinctive: line 17
TFSA / RRSP / FHSA losses are NOT deductible: - only non-registered accounts qualify
- Distinctive: line 18
Superficial loss rule (30 days): if you (or spouse) buy back same security or "substantially identical" one within 30 days before or after …
- Distinctive: line 34
Never recommend selling TFSA/RRSP position for tax reasons
- Distinctive: line 35
Always flag 30-day superficial loss risk
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Tax-Loss Harvesting Review (Canadian rules)
How to run
- Call
mcp__aifolimizer__get_profile- identify which account holds each position (TFSA/RRSP losses NOT deductible) - Call
mcp__aifolimizer__get_personal_context- usederived.marginal_tax_rate_pct+ province to compute each loss's after-tax value (loss × 50% inclusion × marginal rate), so picks are ranked by real tax savings not gross loss. Ifpresent=false, mark the dollar value as an estimate and suggest running profile-setup. - Call
mcp__aifolimizer__get_tax_loss_candidateswith threshold_pct=-5.0 (or stricter -10.0 for clearer picks) - For each candidate, check account placement matters for tax
Key Canadian rules to enforce
- TFSA / RRSP / FHSA losses are NOT deductible - only non-registered accounts qualify
- Superficial loss rule (30 days): if you (or spouse) buy back same security or "substantially identical" one within 30 days before or after sale, loss is denied
- Capital losses in non-registered accounts offset capital gains (current year, carry back 3 years, carry forward indefinitely)
- Substitute trades: typically different but similar ETF (e.g., sell VFV → buy XUS as non-identical S&P 500 proxy) - though "substantially identical" is judgment
Output structure
- Account-by-account breakdown - tax-loss-eligible (non-reg) vs not (TFSA/RRSP/FHSA)
- Ranked list of eligible loss candidates by unrealized loss size
- Per top candidate: ticker, unrealized loss $, %, suggested substitute ETF
- Superficial loss warnings: candidates conflicting with recent buys
- Total deductible loss vs total realized gains YTD (ask user if unknown)
- Action plan: sell list, reinvest list, calendar (avoid 30-day window)
Rules
- Under 400 words
- Never recommend selling TFSA/RRSP position for tax reasons
- Always flag 30-day superficial loss risk
- Suggest substitutes avoiding "substantially identical" designation
Gotchas
- Superficial loss rule covers user AND spouse/common-law partner AND any controlled corp - ask before assuming buy-back window is clean.
- 30-day window is 30 calendar days BEFORE and AFTER sale - both sides count.
- Same-class ETFs tracking same index (e.g. VFV ↔ VOO) likely "substantially identical" per CRA - recommend different index proxy (e.g. VFV → XUS uses different index methodology, safer).
- TFSA losses are PERMANENT - contribution room not restored. Mention when discussing TFSA exits.
- USD-denominated cost basis must be converted at transaction-date FX rate, not current -
get_tax_loss_candidatesmay show CAD-converted loss that misstates actual ACB. Flag and recommend user verify with broker statement. - Capital losses cannot offset interest/dividend income - only capital gains. Don't suggest harvesting to "offset T5 income".
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

