joellewis/finance_skills/corporate-actions
Claude Code and agent skill by joellewis/finance_skills
- community
Checking that the SKILL.md file is still in the repository.
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…
Install
npx vskill@latest install joellewis/finance_skills/corporate-actionsSKILL.md
Corporate Actions
Core Concepts
1. Corporate Action Types
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.
- Cash dividends (regular, special, interim, final)
- Stock dividends (bonus shares distributed pro rata)
- Stock splits (forward splits increase share count, reduce price proportionally)
- Reverse stock splits (decrease share count, increase price proportionally)
- Mergers with fixed terms (cash-only or fixed-ratio stock consideration)
- Spin-offs (new entity shares distributed to parent company holders)
- Name changes and symbol changes (CUSIP/ISIN may change)
Mandatory with Choice. The action will occur regardless, but the holder may choose among alternatives. If no election is made, a default option applies.
- Stock or cash dividend election (holder chooses stock or cash; default is typically cash)
- Merger consideration election (cash, stock, or mixed; subject to proration if oversubscribed)
Voluntary Actions. The holder may choose whether to participate. Non-participation means the holder retains their existing position unchanged.
- Tender offers (issuer or third party offers to purchase shares at a specified price)
- Rights offerings (existing holders receive rights to purchase new shares at a discount)
- Exchange offers (holders may exchange existing securities for different securities)
- Consent solicitations (holders asked to consent to changes in bond covenants or terms)
- Dutch auction tender offers (holders specify price within a range)
- Odd-lot tender offers (small holders may tender at favorable terms)
Information-Only Events. No direct financial impact on positions, but require tracking and communication.
- Annual and special meeting notifications
- Proxy vote solicitations
- Credit rating changes
- Regulatory filings (e.g., issuer SEC filings affecting the security)
2. Corporate Action Lifecycle
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.
3. Record Date and Ex-Date Mechanics
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.
4. Dividend Processing
Dividends are the most frequent corporate action and require systematic processing across declaration, record, ex, and payment dates.
Cash Dividend Lifecycle.
- Declaration date: Board declares dividend amount, record date, and payment date
- Ex-date: Security begins trading without entitlement to the dividend
- Record date: Shareholder register is fixed; holders of record are entitled
- Payment date: Dividend cash is distributed to entitled holders
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.
5. Reorganization Events
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:
- Multiplying each account's position by the split ratio
- Dividing the per-share cost basis by the split ratio (total cost basis is unchanged)
- Updating pending orders and limit prices
- Handling fractional shares per the issuer's policy
- Adjusting option contracts (strike prices and contract multipliers)
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.
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingplugins/client-operations/skills/corporate-actions/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/joellewis/finance_skills/corporate-actions)