plugins/client-operations/skills/corporate-actions/SKILL.md
Process and manage corporate actions from announcement through settlement. Use when handling dividends, stock splits, reverse splits, mergers, or spin-offs, managing voluntary elections for tender offers, rights offerings, or exchange offers, calculating record date and ex-date entitlements under T+1 settlement, collecting and submitting elections to DTC or custodians, handling fractional shares and proration for reorganization events, adjusting cost basis and tax lots after events, reconciling expected entitlements against actual receipts, or investigating missed or incorrectly processed corporate actions.
npx skillsauth add joellewis/finance_skills corporate-actionsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Corporate actions are events initiated by a company that affect its securities. They fall into four broad categories based on the level of shareholder participation required.
Mandatory Actions. These occur automatically for all holders of record and require no election. The holder receives the entitlement without taking any action.
Mandatory with Choice. The action will occur regardless, but the holder may choose among alternatives. If no election is made, a default option applies.
Voluntary Actions. The holder may choose whether to participate. Non-participation means the holder retains their existing position unchanged.
Information-Only Events. No direct financial impact on positions, but require tracking and communication.
Every corporate action follows a sequence from announcement through final settlement. Processing accuracy depends on disciplined execution at each stage.
Announcement. The issuer or its agent announces the corporate action. Data is disseminated through DTCC (via its Corporate Actions product suite, including GCA — Global Corporate Actions), market data vendors (Bloomberg, Refinitiv, ICE Data Services), and exchange filings (SEC EDGAR for US issuers). Multiple vendor sources may report different details or timings, requiring scrubbing and cross-referencing.
Data Scrubbing and Validation. The operations team or automated system receives the raw announcement and validates key fields: event type, security identifiers (CUSIP, ISIN, SEDOL), record date, ex-date, payment/effective date, terms (ratio, price, consideration), election options and deadlines, and default election. Discrepancies between vendor sources must be resolved before the event is set up in internal systems. A "golden source" hierarchy is established (e.g., DTCC as primary for US events, then Bloomberg, then Refinitiv).
System Setup. The validated event is entered into the corporate actions processing system. This includes mapping the event to affected accounts, calculating preliminary entitlements, and flagging accounts that require client notification (for voluntary or mandatory-with-choice events).
Client Notification. For voluntary and mandatory-with-choice events, clients (or their advisors) must be notified with sufficient lead time to make informed elections. Notification includes event description, options available, default election, election deadline, and any relevant analysis (e.g., economic comparison of tender price vs. market price).
Election Collection and Submission. For voluntary events, elections are collected from clients, validated against their positions, aggregated, and submitted to DTC (via PTOP or ATOP systems) or the custodian before the election deadline. Late elections may be rejected or subject to penalty.
Entitlement Calculation. On the record date, the system determines which accounts hold the affected security and calculates entitlements based on position size and event terms (ratio, rate, price). For fractional shares, the system applies the issuer's fractional share policy (cash-in-lieu, round up, round down).
Settlement and Payment. On the payment or effective date, the entitlements are settled: cash is credited, new shares are delivered, old shares are removed, or positions are adjusted. The depository (DTC for US securities) processes bulk entitlements and allocates to participants (custodians/broker-dealers), who in turn allocate to beneficial owner accounts.
Post-Settlement Reconciliation. Actual receipts from the depository or agent are reconciled against expected entitlements. Discrepancies (short pays, over-deliveries, missing allocations) are investigated and resolved through claims processes.
The relationship between record date, ex-date, and settlement cycle is fundamental to correct entitlement processing.
Record Date. The date on which the issuer (via its transfer agent) determines the holders of record who are entitled to the corporate action. Only holders whose names appear on the shareholder register as of the close of business on the record date receive the entitlement.
Ex-Date. The date on or after which the security trades without the entitlement. Under the US T+1 settlement cycle (in effect since May 2024), the ex-date for regular-way dividends equals the record date: a trade executed on the record date settles the next business day, so the buyer is not a holder of record on the record date and does not receive the entitlement. (Under the prior T+2 cycle, the ex-date was one business day before the record date.) Verify the convention for non-US markets, which follow their own settlement cycles.
Cum-Dividend vs. Ex-Dividend. A security trading "cum-dividend" (before the ex-date) entitles the buyer to the upcoming dividend. A security trading "ex-dividend" (on or after the ex-date) does not. On the ex-date, the market price typically drops by approximately the amount of the dividend or the value of the entitlement.
Due Bills. When a trade is executed between the ex-date and the record date under circumstances where normal settlement would result in the wrong party receiving the entitlement, a due bill may be issued. The due bill obligates the seller to pass the entitlement to the buyer. Due bills are more common in complex reorganization events and when settlement cycles change.
International Variations. Ex-date conventions differ by market. Some markets set the ex-date two business days before the record date (under T+2 settlement). Cross-border corporate actions require awareness of each market's convention.
Dividends are the most frequent corporate action and require systematic processing across declaration, record, ex, and payment dates.
Cash Dividend Lifecycle.
Dividend Rate Application. The entitlement is calculated as: shares held on record date multiplied by the per-share dividend rate. For ADRs (American Depositary Receipts), the dividend is declared in the foreign currency and converted to USD, less ADR depositary fees and foreign withholding taxes.
Stock Dividends. Instead of cash, additional shares are distributed. A 5% stock dividend means 5 new shares per 100 held. Fractional shares result when the position is not evenly divisible. The issuer's policy determines whether fractional shares are paid in cash-in-lieu, rounded, or accumulated.
Special and Extra Dividends. One-time or irregular dividends declared outside the normal dividend schedule. These may indicate unusual income, asset sales, or capital return. They require careful classification for tax reporting purposes (ordinary income vs. return of capital).
Return of Capital (ROC). A distribution classified as return of capital is not taxable income in the period received but instead reduces the holder's cost basis. When cost basis reaches zero, further ROC is treated as capital gain. Correct classification requires the issuer's year-end reclassification notice, which may not be available until January or February of the following year. Preliminary estimates may need to be revised.
Qualified vs. Non-Qualified Dividends. US tax law distinguishes between qualified dividends (taxed at capital gains rates) and non-qualified (ordinary income rates). Qualification depends on the issuer being a US corporation or a qualified foreign corporation, and the holding period requirement (held for more than 60 days during the 121-day period surrounding the ex-date). This distinction affects tax reporting on Form 1099-DIV.
Foreign Withholding Tax. Dividends from foreign issuers may be subject to withholding tax by the source country. Treaty rates may reduce the standard withholding rate. The withholding is reported on Form 1099-DIV and may be eligible for a foreign tax credit on the client's tax return. ADR holders face an additional layer of complexity as the depositary bank handles the withholding and may not always apply the optimal treaty rate.
Dividend Reinvestment (DRIP). Clients enrolled in dividend reinvestment plans have their cash dividends automatically used to purchase additional shares. DRIP processing requires: calculating the reinvestment amount (net of any fees), determining the reinvestment price (often the closing price on the payment date, sometimes at a discount), purchasing whole and fractional shares, and creating new tax lots with the reinvestment date and price as the acquisition date and cost basis.
ADR Fees. ADR depositary banks charge periodic fees (typically $0.01-$0.05 per share annually) that are often deducted from dividend payments. These fees must be tracked separately from the gross dividend for accurate tax reporting.
Reorganizations alter the fundamental structure of the security — share count, issuer identity, or security type.
Stock Splits. A forward split increases the number of shares outstanding while proportionally reducing the per-share price. A 2-for-1 split doubles the share count and halves the price. Processing requires:
Reverse Stock Splits. A reverse split reduces the share count and increases the per-share price (e.g., 1-for-10 reverse split converts 1,000 shares into 100 shares at 10x the price). Reverse splits frequently generate fractional shares, which are typically cashed out. This cash-out creates a taxable event for the fractional portion.
Mergers and Acquisitions. When Company A acquires Company B, holders of Company B receive consideration that may be:
Spin-Offs. The parent company distributes shares of a subsidiary as a new, independent company. Processing requires:
Tender Offers. A tender offer is an invitation to shareholders to sell (tender) their shares at a specified price, usually at a premium to market. Processing includes:
Rights Offerings. Existing holders receive rights to purchase additional shares at a discounted subscription price. Each right typically entitles the holder to purchase a specified number of new shares. Processing includes:
Voluntary actions require a structured process to ensure every affected client is notified, elections are collected accurately, and submissions are made on time.
Client Notification Workflow. Upon validating a voluntary event, the system generates notifications to all affected clients or their advisors. Notifications include: event summary, available options with economic analysis (e.g., tender price vs. current market price, subscription price vs. market price), default election if no response is received, election deadline (internal deadline, set earlier than the DTC deadline to allow processing time), and instructions for submitting the election.
Default Election Rules. Firms must establish and disclose default election policies. Common defaults:
Defaults should be documented in the client agreement or disclosed in the notification. The client must have adequate time to override the default.
Election Deadline Management. The critical path for voluntary actions is the election deadline chain:
Missing any deadline in this chain can result in the default election being applied or, worse, the election being rejected entirely.
Election Submission. Aggregated elections are submitted to DTC (via its PTOP/ATOP systems for US securities) or directly to the custodian. The submission must specify: security identifier, event identifier, account or participant details, number of shares electing each option, and any conditions or contingencies.
Over-Election and Proration. When a voluntary action has a cap on participation (e.g., a tender offer limited to 30% of outstanding shares), total elections across all holders may exceed the cap. The agent prorates elections proportionally. Firms must then prorate the accepted quantity back to individual client accounts, typically pro rata by the number of shares each client elected to tender. Fractional share proration results are rounded, with rounding methodology documented and applied consistently.
Late Election Handling. Elections received after the firm's internal deadline but before the custodian or DTC deadline may be processed on a best-efforts basis. Elections received after the DTC deadline are generally rejected. Firms should log all late elections, the reason for lateness, and whether the election was ultimately accepted or rejected, for risk management and client communication purposes.
Corporate actions directly affect position quantities, cost basis, cash balances, and derived calculations across all portfolio accounting and reporting systems.
Cost Basis Adjustments.
Position Quantity Updates. Splits, reverse splits, stock dividends, mergers, and spin-offs all change the number of shares held. The processing system must update positions atomically — removing old positions and creating new positions in a single transaction to avoid transient states that would cause reconciliation breaks.
Cash Posting. Cash dividends, cash-in-lieu of fractional shares, merger cash consideration, tender offer proceeds, and return of capital distributions all generate cash entries. Posting must occur on the correct date (payment date for dividends, settlement date for mergers and tenders) and to the correct account.
Accrued Income Adjustments. For bonds, corporate actions such as issuer defaults, early redemptions, or consent solicitations may affect accrued interest calculations. The system must recognize any accrued interest up to the effective date and adjust subsequent accrual.
Unrealized Gain/Loss Recalculation. After any cost basis adjustment, unrealized gains and losses must be recalculated across all affected tax lots. This affects client reporting, tax projections, and rebalancing decisions.
Tax Lot Updates. Each corporate action must be applied at the individual tax lot level, not at the aggregate position level. A client who acquired shares across multiple dates and prices will have different cost basis amounts per lot, and the corporate action must respect these differences. For a spin-off, every tax lot in the parent position generates a corresponding tax lot in the spin-off position.
Performance Calculation Impact. Corporate actions must be properly reflected in performance calculations to avoid distorting returns. Dividends are investment income. Stock splits and reverse splits are non-economic events that should not create artificial gains or losses. Mergers and spin-offs may require linking old and new securities in the performance calculation engine. The Modified Dietz or daily valuation method must account for corporate action cash flows on the correct dates.
The complexity and time-sensitivity of corporate actions make them a significant source of operational risk. A robust control framework is essential.
Announcement Sourcing Accuracy. Relying on a single data source increases the risk of processing an event based on incorrect terms. Best practice is to cross-reference at least two independent sources (e.g., DTCC and Bloomberg) and flag discrepancies for manual review.
Processing Deadline Management. A deadline calendar or tickler system must track every open corporate action with its key dates (ex-date, record date, election deadline, payment date). Automated alerts should fire at defined intervals before each deadline (e.g., 5 business days, 2 business days, 1 business day before election deadline).
Entitlement Reconciliation. After payment or settlement, expected entitlements (calculated from positions held on the record date) must be reconciled against actual receipts from the depository or custodian. Differences may arise from: positions settling after the record date, DTC claim adjustments, agent errors, or rounding differences. All variances must be investigated and resolved.
Voluntary Action Election Verification. Before submission, elections should be verified against client positions (cannot elect more shares than held), client instructions (election matches what the client requested), and firm policies (no conflicts of interest, appropriate for the client's investment profile). A maker-checker process (one person prepares, another reviews and approves) reduces error risk.
Missed Corporate Action Detection. A periodic scan should compare positions held against a feed of announced corporate actions to detect any events that were not processed. Missed dividends are the most common gap, particularly for thinly traded or foreign securities. A reconciliation of expected vs. received income at the account level is an effective catch-all control.
Error Correction Procedures. When a corporate action is processed incorrectly (wrong ratio, wrong date, wrong accounts), the correction process must: reverse the incorrect entries, apply the correct entries, notify affected clients if the error impacted their statements or tax reporting, and document the root cause and remediation steps. All corrections should be reviewed and approved by a supervisor.
Segregation of Duties. Setup, approval, and submission of corporate actions should involve at least two individuals. The person who enters the event parameters should not be the same person who approves the processing. Incorrectly processed corporate actions can flow through to Form 1099-B (cost basis reporting), Form 1099-DIV (dividend income), and client statements. Errors caught after tax forms are issued require corrected filings, which are operationally burdensome and damage client confidence.
Three numerically worked examples — a cash-and-stock merger with Section 368 basis allocation across tax lots, a tender offer with oversubscription and proration (odd-lot priority, per-account gain calculation), and a spin-off with Form 8937 basis allocation and fractional cash-in-lieu — are in references/examples.md; load it when processing a concrete reorganization event or validating entitlement and basis calculations.
tools
Design, build, and optimize dashboards for RIA practice management with AUM tracking, revenue analytics, and KPI frameworks. Use when the user asks about tracking firm-level metrics, monitoring advisor productivity, measuring organic growth rate, analyzing client retention and attrition, building executive or branch manager views, setting up exception alerts for NIGO and operational items, benchmarking against industry peers, or designing role-based dashboard access. Also trigger when users mention 'how is the practice doing', 'revenue per advisor', 'client attrition', 'net new assets', 'effective fee rate', 'practice benchmarking', 'AUM growth decomposition', or 'advisor capacity'.
testing
Model, forecast, and interpret volatility using time-series models and options-implied measures. Use when the user asks about EWMA, GARCH models, implied volatility, volatility surfaces, volatility term structure, or the VIX. Also trigger when users mention 'volatility smile', 'volatility skew', 'realized vs implied vol', 'volatility risk premium', 'vol clustering', 'mean-reverting volatility', 'options pricing inputs', 'RiskMetrics', 'decay factor', or ask how to forecast future volatility for risk management.
testing
Execute a complete tax-loss harvesting workflow from candidate identification through post-harvest monitoring. Use when the user asks about finding TLH candidates, gain/loss budgeting, replacement security selection, wash-sale compliance, or harvest execution planning. Also trigger when users mention 'unrealized losses in my portfolio', 'swap ETFs for tax purposes', 'harvest losses before year-end', 'substantially identical security', 'wash-sale window', 'NIIT offset', 'loss carryforward', or ask how much tax they can save by harvesting.
testing
Maximizes after-tax returns through strategic asset location, gain/loss management, and withdrawal sequencing. Use when the user asks about asset location, Roth conversions, tax-efficient withdrawals, tax lot selection, or charitable giving with appreciated securities. Also trigger when users mention 'which account should I hold bonds in', 'tax drag', 'Roth vs Traditional', 'RMD planning', 'bracket stuffing', 'HIFO vs FIFO', or ask how to minimize taxes on investments. For tax-loss harvesting execution and wash-sale mechanics, see the tax-loss-harvesting skill.