How does this skill handle wash-sale rules?

It tracks the 61-day window (30 days before and after the sale) across all household accounts, including IRAs and spousal accounts, to prevent permanent loss disallowance.

Does it factor in state taxes?

Yes, the skill calculates tax savings based on federal brackets, state-specific rates, and the 3.8% Net Investment Income Tax (NIIT) to determine the true tax alpha.

Can it suggest replacement securities?

Yes, it identifies ETFs or stocks with high correlation and low tracking error to maintain market exposure without triggering 'substantially identical' security rules.

What criteria does it use to identify harvest candidates?

It uses materiality thresholds such as minimum absolute dollar loss and loss-to-value ratios to ensure the tax benefit outweighs transaction and tracking costs.

Tax-Loss Harvesting Workflow

Name: Tax-Loss Harvesting Workflow
Author: JoelLewis

byJoelLewis

•

Productivity & Workflow

Executes end-to-end tax-loss harvesting workflows to minimize capital gains taxes through candidate identification, replacement selection, and wash-sale compliance.

This skill provides a comprehensive framework for financial advisors and investors to optimize portfolio tax efficiency. It automates the identification of unrealized loss candidates based on materiality thresholds, coordinates gain/loss budgeting across the tax year, and suggests replacement securities to maintain market exposure. Crucially, it manages complex wash-sale compliance across household accounts—including IRAs and spousal accounts—and calculates the net tax alpha of trades by accounting for federal, state, and NIIT impacts.

Key Features

01Multi-account wash-sale monitoring across taxable, retirement, and household accounts

02Strategic replacement security selection to maintain exposure while avoiding wash sales

03Detailed execution planning with HIFO lot selection and rebalancing coordination

04Automated candidate identification using materiality and holding period filters

05Real-time tax savings calculations including federal, state, and NIIT offsets

0618 GitHub stars

Use Cases

01Scanning a high-net-worth portfolio for year-end tax optimization opportunities

02Managing a 61-day wash-sale window across complex multi-account households

03Building a gain/loss budget to offset significant realized capital gains or NIIT exposure

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add joellewis/finance_skills tax-loss-harvesting

For use in Claude.ai and ChatGPT

Download Skill