Install
$ agentstack add skill-joellewis-finance-skills-corporate-actions ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
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.
Mergers and Acquisitions. When Company A acquires Company B, holders of Company B receive consideration that may be:
- All cash: Position in Company B is removed, cash is credited. Taxable event — gain or loss is recognized.
- All stock: Position in Company B is replaced with shares of Company A at the exchange ratio. May qualify as a tax-free reorganization (deferred gain/loss).
- Mixed (cash and stock): Combination of the above. Cash portion ("boot") is taxable; stock portion may be tax-deferred.
- Subject to proration: When the acquirer offers a choice of cash or stock but limits the total cash or stock available, elections are prorated so that each electing holder receives a proportional share of the available pool.
Spin-Offs. The parent company distributes shares of a subsidiary as a new, independent company. Processing requires:
- Allocating the parent's cost basis between the parent and spin-off based on relative fair market values on the distribution date (the issuer typically publishes the allocation percentages via IRS Form 8937)
- Creating new positions for the spin-off shares
- Updating the parent position's cost basis (reduced by the amount allocated to the spin-off)
- Handling fractional spin-off shares (cash-in-lieu)
- Adjusting tax lots individually — each parent tax lot must be split proportionally
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:
- Notifying clients of the offer terms, premium to market, conditions, and deadline
- Collecting elections to tender or not tender
- Submitting tendered shares to DTC or the depositary agent
- Handling proration if the offer is oversubscribed (more shares tendered than the offeror will accept)
- Settling accepted tenders (removing shares, crediting cash)
- Returning un-accepted shares in proration scenarios
- Recognizing capital gains or losses on tendered shares
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:
- Distributing rights to holders of record
- Notifying clients of subscription terms, pricing, and deadline
- Collecting subscription elections and payment
- Processing oversubscription (if the offering allows additional subscriptions beyond the base entitlement)
- Handling unexercised rights (which expire worthless or may be sold on the open market if the rights are transferable)
- Creating new positions for subscribed shares with the subscription price as cost basis
6. Voluntary Action Election Processing
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:
- Tender offers: Default is typically "do not tender" (preserves the client's position)
- Mandatory with choice (stock/cash dividend): Default is typically cash
- Rights offerings: Default is typically "do not subscribe" (rights expire)
- Exchange offers: Default is typically "do not exchange"
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:
- DTC deadline (the hard deadline imposed by the depository)
- Custodian deadline (typically one business day before the DTC deadline)
- Internal firm deadline (typically one to two business days before the custodian deadline)
- Client notification deadline (allowing sufficient time for clients to respond — typically at least five business days before the internal deadline)
Missing any deadline in this chain can resul
…
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: JoelLewis
- Source: JoelLewis/finance_skills
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.