Dividend Calendar — Which Month, How Much?
Please read first. This skill is a tool for calculating past dividend records. It is not investment advice or a solicitation to invest, and it does not recommend buying or selling any security. Past dividends do not guarantee future ones. You alone are responsible for your investment decisions and their outcomes, and the author accepts no legal liability for investment losses based on this tool.
Do you know which month pays, and how much?
When you hold several dividend stocks, it's hard to keep track of what lands this month. Dividend Calendar takes just your holdings and share counts and lays out when, how much, and from which holding the money arrives, month by month, on a single page.
A demo built from real output. The example portfolio (Samsung Electronics, Macquarie Korea Infrastructure, SCHD, Realty Income) is for illustration, not a recommendation.
How to use it
Just tell the agent: "I have 100 shares of Samsung Electronics and 80 of SCHD. Build me a dividend calendar, and tell me how much I'd need to collect 1,000,000 a month."
005930.KS | 100 | Samsung Electronics
SCHD | 80 | SCHD
O | 40 | Realty Income
uv run scripts/div_calendar.py holdings.txt --goal 1000000
After-tax monthly dividends, stacked by holding. The heavy months and the empty ones jump right out.
What it calculates
| Item | Details |
|---|---|
| Monthly calendar | After-tax amount by payout month (estimated from the ex-dividend date) and which holdings pay |
| Per-holding table | Market value, trailing-12-month dividend per share, yield, payouts per year, annual income |
| Portfolio | Annual income before and after tax, monthly average, overall yield, months with no dividend |
| Goal planning | Market value needed for "N per month after tax" and the gap from where you are now (simple math) |
| Currency conversion | Overseas dividends converted at the current FX rate |
| Share card | One 9:16 image (for Stories and blog posts) |
card.png. Shows amounts only, never your holdings or share counts.
What's included
| File | Contents |
|---|---|
SKILL.md |
The input → calculate → interpret workflow and the rules the agent follows |
scripts/div_calendar.py |
The calculator (report, chart, card, JSON) |
examples/holdings.txt |
Example input |
DISCLAIMER.md |
Notice to read before use |
What this skill doesn't do
- Recommend high-yield stocks, suggest what to buy, or predict dividends. Even if you ask the agent, it won't pick securities for you.
- Calculate exact taxes. It applies a flat 15.4% deduction and doesn't account for aggregate income taxation or differences in foreign withholding.
What you'll need
uvand an internet connection. yfinance data is free, so no API key is needed. It's unofficial data and can be wrong or incomplete, so double-check against your brokerage app.
FAQ
Q. Are the payment dates exact? Payout months are estimated from the ex-dividend date, so they can be off by about a month from the real thing.
Q. Does it work with foreign ETFs listed on a local exchange? Yes, as long as yfinance has dividend history for them. If it doesn't, they show up as 0 in the table.
Q. Where does my account information go? It only looks up public quotes by ticker; your share counts and amounts are calculated entirely on your own computer.
Notice This skill and its output are informational calculations on historical data, not investment advice or a solicitation. The accuracy of the data is not guaranteed. Investment decisions and their outcomes are solely your responsibility, and the author accepts no legal liability for investment losses based on it, to the extent permitted by applicable law.
外部API
yfinance
