Token导航 LogoToken导航

Agent Skill · 待分类

tax-loss-harvesting(税收损失收获)

tax-loss-harvesting 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

tax-loss-harvesting 是待分类类 Agent Skill,可用宿主为 Codex、Claude、Cursor、Gemini CLI,通过GitHub 仓库获取,权限为需要联网;许可证信息还不明确,第三方扫描已通过,按安装量在待分类类的 11,209 个 Skill 里排第 2,340。

总安装 1,665周安装 68GitHub Stars 58下载 533核验 2026-05-01

安装说明

本站只整理中文说明,不托管安装包,也不代用户安装。
GitHub
许可证
unknown

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:tax-loss-harvesting(税收损失收获)
来源仓库:https://github.com/joellewis/finance_skills
仓库路径:skills/tax-loss-harvesting
安装命令:
npx skills add https://github.com/joellewis/finance_skills --skill tax-loss-harvesting
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/joellewis/finance_skills --skill tax-loss-harvesting

这个 Skill 是做什么的

这个 Skill 的分类还没最终确定,用法以来源仓库的说明为准。

tax-loss-harvesting 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息。适合在 Codex、Claude、Cursor、Gemini CLI 中围绕仓库状态或代码变更进行整理。通过 npx skills add 命令从指定仓库安装并使用。

建议确认权限范围和维护状态,注意是否触发联网或文件读写。可结合来源仓库和 README 进一步核验具体用法。

来源仓库内路径:skills/tax-loss-harvesting

上手步骤

4 步
  1. 1

    确认自己的宿主工具

    公开资料标注支持 Codex、Claude、Cursor、Gemini CLI;先确认自己用的是其中之一,再按对应工具的 Skills 目录放置。

  2. 2

    拿到安装命令

    可以直接复制的命令是 npx skills add https://github.com/joellewis/finance_skills --skill tax-loss-harv…;命令里的占位符换成自己的路径或密钥再执行。

  3. 3

    安装后重启宿主

    命令执行完要完全退出宿主工具再打开,让新装的 Skill 被重新扫描到,否则列表里可能看不到。

  4. 4

    按最小权限试用

    它需要需要联网,先在测试目录或测试账号里跑,确认没问题再放到正式项目。

常见问题

6 条

tax-loss-harvesting 怎么安装?

在终端执行 npx skills add https://github.com/joellewis/finance_skills --skill tax-loss-harvesting。装完完全退出宿主工具再打开,让它重新扫描本地 Skill。

tax-loss-harvesting 支持哪些 AI 工具?

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录,一般也能手动放进去,但要自己确认触发方式是否一致。

tax-loss-harvesting 需要什么权限?

权限级别是需要联网。该 Skill 可能需要联网访问来源站点、仓库或外部 API;具体网络访问范围需要结合源码和 README 复核。

tax-loss-harvesting 是免费的吗?

公开资料没有标注明确许可证,收费和商用限制都无法确认。正式使用前请到来源仓库核对授权说明。

tax-loss-harvesting 用的人多吗?

公开数据是累计安装 1,665 次,近一周安装 68 次,下载 533 次,GitHub 58 星。这些数字来自第三方目录统计,只能当作热度参考,不代表质量或安全性。

tax-loss-harvesting 安全吗?

第三方扫描结果为通过,但这只覆盖已知的静态检查项,不能替代自己读一遍源码和安装命令。

值得选的地方和要先想清楚的地方

值得选的地方

  • 同时适配 4 种工具,换客户端不用重新找替代品。
  • 第三方扫描已通过,常见的高风险行为没有命中。

先想清楚的地方

  • 许可证没有明确标注,能不能商用、能不能再分发都不确定。
  • 第三方目录整理,版本更新和行为细节以来源仓库为准。

适不适合你

更适合

  • 已经在用 Codex,想直接扩展它能力的人。
  • 需要处理待分类类任务、又不想每次都手写提示词的人。

不太适合

  • 需要明确授权才能用到公司项目里的场景。
  • 需要厂商级技术支持和 SLA 的生产系统。

待分类类 Skill 对比

6 个同类
Skill总安装GitHub 星权限许可证扫描
infsh-cli

infsh CLI · Codex、Claude

4,374,576382权限未标注未明确未收录
ai-video-generation

AI 视频生成 · Codex、Claude

4,313,376382调用外部服务未明确有提醒
lark-openapi-explorer

云雀 OpenAPI 浏览器 · Codex、Claude

2,064,1209,011需要联网未明确有提醒
lark-workflow-standup-report

Lark 工作流程站立报告 · Codex、Claude

2,041,6328,978需要联网未明确通过
use-my-browser

使用我的浏览器 · Codex、Claude

1,848,49140操作浏览器未明确未通过
tax-loss-harvesting

税收损失收获 · 本页

1,66558需要联网未明确通过

按安装量取同分类前几名;数字来自第三方目录统计,只作热度参考,不代表质量结论。

SKILL.md 原文

Tax-Loss Harvesting

Purpose

Execute a complete tax-loss harvesting (TLH) workflow from candidate identification through post-harvest monitoring. Provides decision criteria, quantitative thresholds, replacement security selection logic, wash-sale compliance tracking across accounts, and household-level coordination that go beyond the overview in the tax-efficiency skill.

Layer

5 — Policy and Planning

Direction

both

When to Use

  • Scanning a portfolio for unrealized losses that exceed a materiality threshold
  • Building a gain/loss budget for the current tax year to determine target harvest amount
  • Selecting replacement securities that maintain factor exposure without triggering wash-sale rules
  • Tracking the 61-day wash-sale window across taxable, IRA, and spouse accounts
  • Generating a TLH trade list coordinated with rebalancing
  • Calculating the after-tax value of a proposed harvest including state taxes and NIIT
  • Monitoring replacement positions and planning swap-back timing after the wash-sale window closes
  • Preparing TLH opportunity summaries for client reviews

Core Concepts

Candidate Identification

Scan the portfolio for positions with unrealized losses that meet all three filters:

  • Materiality threshold: Minimum absolute loss (e.g., $2,000) or minimum loss-to-value ratio (e.g., loss exceeds 5% of position market value). Harvesting a $200 loss on a $50,000 portfolio is not worth the operational cost.
  • Holding period filter: Positions held less than 31 days may not have meaningful losses and create short-term wash-sale complexity. Positions approaching the one-year mark (days 335-365) may benefit from waiting to convert a short-term loss into a long-term loss only if the position is expected to continue declining.
  • Loss magnitude ranking: Rank candidates by Tax Benefit = Unrealized Loss * Applicable Tax Rate. Prioritize short-term losses (taxed at ordinary rates up to 37%) over long-term losses (taxed at capital gains rates of 15-20%) when gain/loss budget allows.

Gain/Loss Budgeting

Before harvesting, build the year-to-date tax budget:

  1. Realized gains YTD: Sum all short-term and long-term capital gains already realized (including fund distributions).
  2. Planned gain exposure: Estimate gains from pending rebalancing trades, planned liquidations, or expected fund capital gain distributions.
  3. Loss carryforward balance: Check prior-year unused capital loss carryforwards (these offset gains before new harvests do).
  4. Target harvest amount: Target Harvest = (Realized Gains YTD + Planned Gains) - Loss Carryforward - $3,000 ordinary income offset. Harvest at least this amount to zero out the current-year tax bill; harvest more to build carryforward for future years.

Replacement Security Selection

The replacement must maintain market exposure without being "substantially identical":

  • ETF-to-ETF swaps: Switch between funds tracking different indices (e.g., Vanguard Total Stock Market to Schwab Broad Market, or S&P 500 to Russell 1000). Different index methodology is generally sufficient.
  • Individual stock replacement: Replace a single stock with a sector ETF or a peer company. Example: sell Apple, buy Technology Select Sector SPDR (XLK).
  • Tracking error budget: The replacement should have a correlation of 0.95+ and tracking error under 2% annualized relative to the original holding. Wider tracking error is acceptable for larger tax benefits.
  • Expense ratio delta: Ensure the replacement does not have meaningfully higher expenses. A 10 bps cost increase on a $100K position held for 30 days costs roughly $8 — negligible against a $2,000+ tax benefit.

Wash-Sale Compliance

The wash-sale rule (IRC Section 1091) disallows a loss if a substantially identical security is acquired within the 61-day window (30 days before + sale date + 30 days after):

  • Cross-account scope: The rule applies across ALL accounts owned by the taxpayer: taxable brokerage, Traditional IRA, Roth IRA, 401(k), HSA, and spouse's accounts. A purchase in any of these accounts triggers wash-sale disallowance.
  • IRA wash-sale trap: If a wash sale is triggered by a purchase in an IRA, the disallowed loss is permanently lost — it cannot be added to the IRA cost basis. This is the most dangerous wash-sale scenario.
  • DRIP suspension: Automatic dividend reinvestment (DRIP) in the sold security or a substantially identical fund must be suspended during the 61-day window. Reinvesting even a small dividend triggers a partial wash sale.
  • Spouse coordination: Purchases in a spouse's accounts (including retirement accounts) trigger wash-sale rules. Both spouses' automatic investments, 401(k) contributions, and DRIP settings must be reviewed.

Execution Planning

Translate candidates into an actionable trade list:

  • Lot selection method: Use Specific Identification (Spec ID) to select the highest-cost-basis lots first (HIFO). This maximizes the realized loss per share sold. If only partial harvesting is needed, sell only the lots with cost basis above current market price.
  • Coordination with rebalancing: If the portfolio also needs rebalancing, combine TLH sells with rebalance sells to reduce total trade count. A position that is both overweight and at a loss is the ideal candidate — the harvest and rebalance are the same trade.
  • Timing strategy: Year-end harvesting (October-December) captures the full year's losses but faces market timing risk. Opportunistic harvesting throughout the year during drawdowns of 5%+ captures losses that may recover by year-end.
  • Trade list fields: Security, account, action (sell/buy), shares, lot IDs, estimated loss, replacement security, wash-sale window start/end dates.

Tax Savings Calculation

Quantify the dollar value of each proposed harvest:

  • Federal rate selection: Short-term losses offset short-term gains first (up to 37% ordinary rate). Long-term losses offset long-term gains (15-20% rate). Net losses of either type can cross over to offset the other, then up to $3,000 offsets ordinary income.
  • State tax impact: Most states tax capital gains as ordinary income (rates 0-13.3%). Include state tax savings in the calculation; for a California resident at the 13.3% bracket, state tax roughly doubles the benefit of each harvest.
  • NIIT interaction: The 3.8% Net Investment Income Tax (IRC Section 1411) applies to the lesser of net investment income or MAGI exceeding $250,000 (MFJ). Harvested losses reduce net investment income, potentially eliminating NIIT exposure.

Post-Harvest Monitoring

After executing the harvest:

  • Wash-sale window tracking: Maintain a calendar of open wash-sale windows with security identifiers and expiration dates. Flag any pending purchases (including automated ones) that would violate the window.
  • Replacement performance: Monitor tracking error between the replacement and original security. If the replacement significantly underperforms (>3% divergence), evaluate whether the tax benefit justified the swap.
  • Cost basis updates: Verify that broker statements reflect the new (lower) cost basis on replacement securities. The replacement's basis equals purchase price, not the original security's basis.
  • Swap-back timing: After the 31st day, the investor may sell the replacement and repurchase the original security if desired. Evaluate whether the swap-back itself triggers a taxable gain on the replacement position.

Household-Level Coordination

TLH across a household with multiple accounts requires centralized tracking:

  • Account type matrix: Taxable accounts are the only accounts where TLH generates direct tax benefits. Retirement accounts have no realized gains/losses for tax purposes, but they can trigger wash sales in taxable accounts.
  • Advisor-managed vs held-away: If the client has accounts at other institutions (401(k) plan, outside brokerage), the advisor cannot control purchases. Document held-away holdings and instruct the client to avoid purchasing substantially identical securities during open wash-sale windows.
  • Spousal coordination checklist: (1) Review spouse's 401(k) fund lineup for overlap, (2) suspend DRIP in spouse's accounts for harvested securities, (3) coordinate any year-end tax trades across both spouses.

Key Formulas

FormulaExpressionUse Case
Tax BenefitBenefit = Realized_Loss * Applicable_Tax_RateDollar value of a single harvest
Net Tax AlphaAlpha = Tax_Savings - Tracking_Error_Cost - Transaction_CostsTrue value after implementation costs
Break-Even Holding PeriodT_be = Tax_Savings / (Annual_Tracking_Error_Cost + Annual_Expense_Delta)How long replacement can be held before costs exceed benefit
Wash-Sale Adjusted BasisNew_Basis = Replacement_Purchase_Price + Disallowed_LossCost basis when wash sale is triggered
Annual TLH CapacityCapacity = Portfolio_Value * Expected_Volatility * Loss_Capture_RateEstimate of harvestable losses per year
Target Harvest AmountTarget = Realized_Gains_YTD + Planned_Gains - Loss_Carryforward - 3000Minimum harvest to zero out current-year tax

Worked Examples

Example 1: Single Position Harvest with Replacement Selection

Given:

  • Client holds 500 shares of XYZ Corp purchased at $80/share ($40,000 cost basis), current price $62/share ($31,000 market value), held 8 months (short-term)
  • Client has $12,000 in short-term realized gains YTD, marginal federal rate 35%, state rate 9.3%, NIIT applies (3.8%)
  • Replacement candidate: Sector ETF (correlation 0.97, tracking error 1.4% annualized, expense ratio 0.10% vs 0% for individual stock)

Calculate: Tax benefit, net tax alpha, and break-even holding period for the replacement.

Solution:

  1. Unrealized loss: $31,000 - $40,000 = -$9,000 (short-term)
  2. Applicable rate: 35% federal + 9.3% state + 3.8% NIIT = 48.1% combined
  3. Tax benefit: $9,000 * 48.1% = $4,329
  4. Transaction costs: Commission $0 (zero-commission broker) + estimated spread cost 0.05% * $31,000 * 2 trades = $31
  5. Tracking error cost: 1.4% annualized * $31,000 * (30/365) = $36 (for the 30-day minimum hold)
  6. Net tax alpha: $4,329 - $31 - $36 = $4,262
  7. Annual cost of replacement: $31,000 * (0.10% expense + 1.4% tracking error drag estimate of 0.05%) = $46.50/year
  8. Break-even holding period: $4,262 / $46.50 = 91.7 years — the tax benefit overwhelmingly justifies the swap
  9. Action: Sell XYZ Corp (Spec ID, all lots), buy Sector ETF. Set wash-sale window reminder for 31 calendar days. Suspend any XYZ DRIP in all household accounts.

Example 2: Portfolio-Wide TLH Scan with Gain/Loss Budget

Given:

  • $2M taxable portfolio, 15 equity positions, year is mid-October
  • Realized gains YTD: $18,000 long-term, $5,000 short-term
  • Loss carryforward from prior years: $0
  • Planned rebalancing trades will realize approximately $4,000 in additional long-term gains
  • Three positions show unrealized losses: Position A (-$14,000 LT), Position B (-$6,500 ST), Position C (-$2,100 LT)
  • Federal LTCG rate 20%, ordinary rate 37%, state 5%, NIIT 3.8%

Calculate: Target harvest amount, prioritized trade list, and total tax savings.

Solution:

  1. Gain/loss budget:

- Total expected gains: $18,000 LT + $5,000 ST + $4,000 LT (planned) = $22,000 LT + $5,000 ST - Loss carryforward: $0 - Target harvest: ($22,000 + $5,000) - $0 - $3,000 = $24,000 to fully offset gains and capture the $3,000 ordinary income deduction

  1. Candidate ranking by tax benefit:

- Position B: $6,500 ST * (37% + 5% + 3.8%) = $6,500 * 45.8% = $2,977 (highest rate — harvest first) - Position A: $14,000 LT * (20% + 5% + 3.8%) = $14,000 * 28.8% = $4,032 (largest absolute benefit) - Position C: $2,100 LT * 28.8% = $605

  1. Harvest plan: Harvest all three: $14,000 + $6,500 + $2,100 = $22,600 in total losses

- $5,000 ST losses offset $5,000 ST gains at 45.8% = $2,290 saved - $1,500 remaining ST losses cross over to offset LT gains at 28.8% = $432 saved - $16,100 LT losses offset $16,100 of $22,000 LT gains at 28.8% = $4,637 saved - Remaining $5,900 LT gains still taxable; $3,000 ordinary income offset not reached (all losses consumed by gains) - Total tax savings: $7,359

  1. Coordinate with rebalancing: Position A is also 2% overweight — its TLH sell doubles as a rebalance sell, saving one round-trip trade.

Example 3: Wash-Sale Violation Across Accounts

Given:

  • On November 5, client sells VTI (Vanguard Total Stock Market ETF) in taxable account for a $8,000 long-term loss
  • On November 20 (15 days later), client's 401(k) makes its regular bi-weekly contribution, which includes an allocation to a Vanguard Total Stock Market Index Fund (institutional share class of the same fund)
  • 401(k) contribution to the total stock market fund: $750

Calculate: Wash-sale impact and corrected cost basis.

Solution:

  1. Wash-sale triggered: The 401(k) fund is substantially identical to VTI (same underlying index, same fund family). The purchase on November 20 falls within the 30-day post-sale window (November 5 + 30 = December 5).
  2. Disallowed loss: The wash-sale disallowance is proportional to the replacement shares acquired. If 500 VTI shares were sold and the $750 401(k) purchase acquired the equivalent of approximately 3 shares at $250/share, then 3/500 = 0.6% of the loss is disallowed.
  3. Disallowed amount: $8,000 * (3/500) = $48 disallowed
  4. Remaining allowable loss: $8,000 - $48 = $7,952 — still deductible
  5. Basis adjustment — 401(k) trap: The $48 disallowed loss would normally be added to the replacement security's cost basis. However, because the replacement was purchased inside a 401(k), the cost basis adjustment provides NO future tax benefit (401(k) distributions are taxed as ordinary income regardless of basis). The $48 is permanently lost.
  6. Prevention: Before executing TLH, review the client's 401(k) fund lineup and contribution schedule. If the 401(k) holds a substantially identical fund, either (a) temporarily redirect that 401(k) allocation to a non-identical fund during the wash-sale window, or (b) delay the TLH sale until after the next 401(k) contribution and ensure no contribution occurs for 30 days after.

Common Pitfalls

  • Harvesting losses without checking for substantially identical holdings in retirement accounts, triggering permanent loss disallowance in IRAs/401(k)s
  • Forgetting to suspend DRIP on the sold security and related funds across all household accounts during the 61-day window
  • Harvesting small losses (under $1,000) where transaction costs and operational complexity exceed the tax benefit
  • Over-harvesting in early years, depressing cost basis so severely that future sales generate outsized gains (basis step-down compounding)
  • Failing to coordinate with spouse's automated investments (401(k) payroll contributions, robo-advisor purchases)
  • Selecting a replacement security that is substantially identical (same index, same fund family, different share class) — this does not avoid wash-sale rules
  • Not tracking the holding period of replacement securities, leading to unintended short-term gains when the replacement is later sold
  • Ignoring state tax differences when calculating harvest value — states with no income tax (FL, TX, NV) reduce the benefit by 5-13 percentage points versus high-tax states

Cross-References

  • tax-efficiency (wealth-management plugin, Layer 5): broader tax-aware investing context; TLH is one strategy within the overall tax-efficiency framework
  • rebalancing (wealth-management plugin, Layer 4): TLH trades should be coordinated with rebalancing to minimize total transaction count
  • investment-suitability (compliance plugin, Layer 9): replacement securities must still satisfy suitability requirements
  • investment-policy (wealth-management plugin, Layer 5): IPS may specify TLH policy parameters (minimum loss threshold, approved replacement pairs)
  • performance-attribution (wealth-management plugin, Layer 5): tax alpha from TLH should be tracked and attributed separately
  • client-review-prep (advisory-practice plugin, Layer 10): TLH opportunities are flagged during periodic client review preparation
  • financial-planning-workflow (advisory-practice plugin, Layer 10): TLH is a specific tax recommendation that may emerge from the financial plan

平台分布

Codex

34.62%
按下载量换算185

Claude

30.44%
按下载量换算162

Cursor

20.84%
按下载量换算111

Gemini CLI

8.9%
按下载量换算47

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

需要联网

该 Skill 可能需要联网访问来源站点、仓库或外部 API;具体网络访问范围需要结合源码和 README 复核。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。目前只有一个公开来源,建议同时核对源仓库。

继续浏览同类 Skills