Agent skill

Catalyst Calendar

by ginlix-ai in ginlix-ai/LangAlpha

Builds a ranked calendar of dated events such as earnings, regulatory decisions, flows and macro releases, ordered by what each can change, with prep owners and a weekly preview.

Apache-2.0Auto-check passedBusiness, Finance & HR

Install Catalyst Calendar

skills CLI
$ npx skills add ginlix-ai/LangAlpha --skill catalyst-calendar -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ginlix-ai/LangAlpha catalyst-calendar --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ginlix-ai/LangAlpha.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/langalpha_research/skills/catalyst-calendar .claude/skills/catalyst-calendar && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
catalyst-calendar
GitHub stars
1.8k
Token cost
~3.6k tokens
SKILL.md length
2,087 words
Files
2 (incl. references)
Skills in repo
37
Repo updated
First seen
Licence
Apache-2.0

At a glance

Builds a ranked calendar of dated events such as earnings, regulatory decisions, flows and macro releases, ordered by what each can change, with prep owners and a weekly preview.

  • Works in 7 steps: Scope the universe → Gather events and classify by investment… → Score materiality and actionability → …
  • Preparing a weekly preview of upcoming earnings and macro events
  • SKILL.md covers Step 1: Scope the universe, Step 2: Gather events and…, Step 3: Score materiality and… and Step 4: Build the calendar, plus 3 more sections
  • Calls python

What it does

A catalyst calendar here is a decision-pressure ranking, not a list of dates: an event earns a place because it can move the estimate path, the narrative, the multiple, position size, the downside case, liquidity or the odds of another event. Proximity alone ranks nothing, so a high-materiality readout in eleven weeks outranks a routine print on Thursday. Step one scopes the universe (tickers, a portfolio or watchlist file, a sector or an index), the horizon, whether macro and policy dates are in scope, and whether the output stays on the desk or goes outside.

Step two gathers events live instead of from memory, using a macro MCP for earnings and economic calendars, a company overview tool, and web search and fetch for items no feed carries, such as regulatory dockets, trial readouts, lockups and contract expiries. Company, regulator and exchange sources override aggregators, and date disagreements are kept and logged as conflicts. With nothing supplied, a default calendar covers a rolling ninety days. Shared conventions come from a research-conventions skill, and the excerpt is cut off at the event groups.

When your agent uses it

  • Preparing a weekly preview of upcoming earnings and macro events
  • Ranking upcoming events for a watchlist by what could move positions
  • Deciding which events need a prep owner before they land

Example prompts

  • “Build a catalyst calendar for my watchlist covering the next quarter.”
  • “What should I prepare for over the next two weeks across these five tickers?”
  • “Make a weekly event preview for the semiconductor sector, for internal desk use only.”

Requirements

  • A macro MCP server with earnings and economic calendar tools
  • The research-conventions skill

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Scope the universe
  2. Gather events and classify by investment path
  3. Score materiality and actionability
  4. Build the calendar
  5. Prep plan, per-event block and the weekly preview
  6. Refresh without destroying history
  7. Output

What it can do on your machine

Read from SKILL.md and the folder at commit 2855e43. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Catalyst Calendar loads about 3.6k tokens when it runs, and up to ~5.6k if it reads all its reference files. Until then it costs about 77 tokens; SKILL.md has 2,087 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~77
When it runs · the whole SKILL.md, loaded when a task matches
~3.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ginlix-ai/LangAlpha at commit 2855e43, republished under its Apache-2.0 licence (© ginlix-ai). 2,087 words, ~3,596 tokens.

Download SKILL.mdSave it as .claude/skills/catalyst-calendar/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
catalyst-calendar
description
Dated events ranked by what they can change: earnings, regulatory decisions, flow events, macro releases, with prep owners and a weekly preview. Triggers on catalyst calendar, upcoming events, what is coming up, earnings calendar, event calendar, catalyst tracker, what should I prepare for.

Catalyst Calendar

A calendar of dates is a list; a catalyst calendar is a decision-pressure ranking. An event earns its place because it can move the estimate path, the narrative, the multiple, position size, the downside case, liquidity, or the odds of another event. Proximity alone ranks nothing: a high-materiality readout in eleven weeks outranks a routine print on Thursday, and the routine print belongs in a hygiene block.

Evidence labels, source tiers, staleness, the readiness posture and the intake limits: .agents/skills/research-conventions/SKILL.md, read before the first deliverable.

Step 1: Scope the universe

Settle four things, taking the mandate and horizon from memory per .agents/skills/research-conventions/references/intake.md and asking only about what it leaves open:

  • The universe: tickers, a portfolio or watchlist file, a sector, or an index.
  • The horizon: the next two weeks, a month, a quarter, or through the next reporting season.
  • Whether macro releases and policy dates are in scope, or only issuer events.
  • Whether the output goes to the desk or outside it, which decides the externally clean rule in step 7.

With nothing supplied, ask for one of those four concrete inputs and say what the default calendar will contain once it arrives (a rolling ninety days, issuer events plus the macro releases that bind the sector).

Done when the universe resolves to a named list of issuers, the horizon has dates, and the macro decision is recorded and the destination is recorded as desk or external.

Step 2: Gather events and classify by investment path

Pull live rather than recalling:

  • Macro MCP: get_earnings_calendar(from_date, to_date) for every reporter in the window, and get_economic_calendar(from_date, to_date) for releases and policy dates.
  • get_company_overview for the issuer's reporting history and consensus context.
  • WebSearch and WebFetch for the events no calendar feed carries: regulatory dockets, trial readouts, conference agendas, lockup schedules, contract expiries.

Company, regulator and exchange sources override an aggregator. When two sources disagree on a date, keep both, mark the row's confidence at the lower level, and write the disagreement as a conflict-register row per .agents/skills/research-conventions/references/evidence.md.

Event groups

Earnings and financial: quarterly results with session (pre-market, post-close), annual meeting, investor or capital-markets day, guidance updates, debt maturities and refinancings, dividend and buyback authorisations.

Corporate: product launches, regulatory decisions and their preceding milestones, contract renewals and expirations, M&A milestones (shareholder vote, regulatory clearance, close), management transitions, litigation dates.

Industry: conferences and which issuers present, trade shows, comment periods and rulings, recurring industry data (monthly sales, traffic, channel checks).

Macro: policy meetings, labour, inflation and growth releases, central bank decisions elsewhere, scheduled geopolitical dates.

Index and passive flow: index additions, deletions, rebalances and reconstitutions; lockup expiries; secondaries and block trades; convertible issuance and conversion; buyback blackout windows; float changes. Each carries the fields that make it assessable: expected flow in shares and in days of average daily volume, the holder base behind the supply, and the float change in percentage points. This group is mechanical supply and demand, so it is kept apart from anything fundamental in the write-up.

Classify by the path, not the headline

The classification decides what the row must contain to be useful, so it happens as the event is captured. A merger date needs the spread, the implied probability and the break-price arithmetic; a spin needs a parts-based value and a forced-selling estimate; an activist date needs the vote arithmetic; a litigation date needs merits, timing, damages and the settlement path; a flow event needs flow against average daily volume. Per-class core questions, required outputs and the must-extract list from the primary document: .agents/skills/catalyst-calendar/references/event-lenses.md, read when a captured event falls outside the earnings and macro classes you already handle, and again when a P1 row needs the action block of step 5 filled.

Timing fields

Every row carries a date type and a date confidence, kept separate because a rumoured hard date and a company-guided window fail differently.

Date typeRenders as
harda single date, with the session where it matters
windowits span, in the table, in the workbook and in any export
ConfidenceBasis
confirmeda primary source states it: the issuer, the regulator, the exchange, the docket
guidedthe company said roughly when, without committing to a date
expecteda reliable aggregator carries it and the issuer has not confirmed
inferredderived from the reporting cadence, a statutory clock or a contractual term
rumouredreported by media or a market participant with no primary support
undatedthesis-critical, and no date can be established yet

A window renders as its span everywhere it appears, including a calendar export, and the export carries only rows whose date type is hard. Presenting "second half" as one Tuesday manufactures a date the issuer never gave.

An undated row keeps the event: undated thesis-critical events go to a review table with what would date them (a statutory clock, a filing, a conference agenda), not to the cutting-room floor.

Source metadata per row: source name, retrieval date, the publication date of the date itself when it differs, and a last-checked timestamp.

Done when every captured event carries a category, a class, a date type, a date confidence and its source metadata, and every undated thesis-critical event sits in the review table.

Step 3: Score materiality and actionability

Two independent one-to-five scores, combined by judgement rather than multiplied:

  • Materiality: how much the event can move the estimate path, the narrative, the multiple, the downside case, position size, liquidity, or the probability of a later event. A 5 changes the thesis; a 1 changes nothing we track.
  • Actionability: how much we can do about it. A 5 has prep time, a tradable expression and the inputs a decision needs; a 1 is a fact we learn afterwards.

Priority is P1, P2 or P3, written with the sentence that justifies it. A high-materiality, low-actionability event is still P1 when its outcome resets the model.

Escalators. Any one of these promotes an event above its base score, and the row names which fired:

  1. It lands within a week and the prep is not done.
  2. Date confidence is low while materiality is high.
  3. It collides with another portfolio-critical event.
  4. Expected volatility is high or the name trades thinly.
  5. The market setup is one-sided (crowded positioning, a stretched multiple, consensus clustered).
  6. The asymmetry is not reflected in consensus.
  7. It can trigger follow-on catalysts.
  8. Missing data is blocking a clean risk decision.

Clustering. Flag every date carrying events for two or more correlated positions, and flag the week where portfolio-level event risk concentrates. A cluster is its own catalyst.

Done when every row carries both scores, a priority with its one-line justification, the escalators that fired, and a clustering flag where a date is shared.

Step 4: Build the calendar

Canonical fields per event, all of them in the workbook, the readable subset in the markdown view:

event_id (stable across refreshes), issuer and ticker, category and subcategory, event name, one-line description, date, date type, date confidence, session and time zone, source, retrieval date, date publication date, last checked, materiality, actionability, priority, escalators fired, expected outcome, what to watch for variance, prep required, prep owner, prep due date, follow-up date, decision implication, post-event action.

Markdown view:

DateType / confidenceIssuerEventClassMaterialityActionabilityPriorityPrep ownerDueDecision it supports

Routine dates that nothing hangs on group into a hygiene block underneath, listed but unranked.

Done when every row shows its date type and confidence beside the date, every window row shows a span, and every P1 and P2 row names the decision it supports.

Show full SKILL.md (831 more words)Show less

Step 5: Prep plan, per-event block and the weekly preview

Each P1 and P2 event gets a prep item: the work product, the owner, the due date, and the decision it supports. A prep item with no due date is a wish.

Per-event action block, written for every P1:

  • Setup and current debate: what the market is arguing about going in.
  • Metrics that will matter: the two or three numbers the reaction hangs on.
  • Expectation frame: guidance, consensus with its vintage, the buy-side bogey where it is observable, the options-implied move with its session, and prior commentary.
  • Our variant view: where we differ, and the evidence behind the difference.
  • Confirm and disconfirm thresholds: the level on each side that changes something.
  • Prep plan: the items above, with owners.
  • Post-event playbook: what each outcome triggers, written before the event so the reaction is not composed under time pressure.

Weekly preview, the cadence artifact:

This week: each day, the event, why it matters for which names, consensus and our estimate where it is an earnings date, and the metric in focus. Next week: the heads-up on what needs prep started now. Position implications: what could move, what prep is outstanding, and the risk decision each binary event forces.

Horizon framing beyond the two-week view: the next thirty days carry high-materiality events, overdue prep and unresolved source conflicts; sixty days carry the events whose pre-work starts now; ninety days carry long-lead workstreams (a model rebuild, an expert call, a channel check).

Done when every P1 and P2 event has a named prep owner and a due date, every P1 carries its action block including the post-event playbook, and the preview names next week's prep starts.

Step 6: Refresh without destroying history

A refresh appends. Match incoming events on event_id, keep every prior row, and record what changed:

  • A date that moved: keep the row, update the date, add the prior date and the source that moved it to the row's history.
  • A row the sources no longer carry: mark it stale with the date it was last confirmed, rather than deleting it.
  • A confidence that improved (expected to confirmed): update it and note the primary source that confirmed.
  • A row that resolved: mark it complete, record the actual outcome against the expected outcome, and keep it. The archive of what happened against what was expected is what makes the next preview sharper.

Emit a dated change log with three counts and their rows: added, changed, flagged.

Done when the change log lists every row added, changed and flagged, and no prior row was deleted or overwritten in place.

Step 7: Output

Save to {task}/.

  • Excel workbook with the canonical fields, sortable and filterable by priority, class and date. Formatting and conventions per .agents/skills/xlsx/SKILL.md, then python .agents/skills/xlsx/scripts/recalc.py calendar.xlsx 60.
  • Weekly preview note in markdown.
  • A single-event brief when the user asks about one date: timing with its type, confidence and source; the setup; the market expectation; what could surprise; confirming and disconfirming evidence; the prep; the post-event action; and the source caveats.

Externally clean output. A calendar leaving the desk carries dates, sources, confidence and public expectations. Our positions, cost basis, target prices, variant view and trade intent stay in the desk version, and the two are separate files rather than one file with hidden columns.

Delivery checklist

Run this before handing the calendar over. Two checks are hard: they pass, or the calendar does not go out.

Hard checkFails when
File safetya user file was overwritten rather than extended, or the desk version left the desk
Date honestya readout or approval window was rendered as one day, its endpoint is unstated, or a date is presented harder than its type and confidence support

The rest are research checks, the errors this artifact actually makes. One still open is disclosed on its own line in the delivery note, with what it costs the calendar's coverage:

Research checkFails when
Date provenancean earnings date came from a secondary source and no primary source confirms it
Flow completenessa lockup or secondary appears with no share count, holder base or days of volume
Regulatory precisionfiling, acceptance, advisory committee, decision and launch are used interchangeably
Macro relevancea macro release is listed with no stated link to a name in the universe
Conference realitya conference is listed without confirming which issuers present
Timestamped expectationsconsensus or guidance appears without its vintage
Scheduled workan event requires a model update and no prep item carries it
Priority sanityan event with a direct thesis linkage sits at P3
Calendar hygieneduplicates survive, time zones are mixed, or a cluster is unflagged
PM usefulnessa row says what happens without saying what could change

Done when both hard checks pass, one posture from the ladder in .agents/skills/research-conventions/SKILL.md is stated near the top of the calendar, and every research check either passes or is named individually in the delivery note with its effect on coverage.

© ginlix-ai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in plugins/langalpha_research/skills/catalyst-calendar of ginlix-ai/LangAlpha.

  • SKILL.md
  • references/event-lenses.md

Open the folder on GitHubat commit 2855e43

Compare with similar skills

Catalyst Calendar next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Catalyst Calendar compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Catalyst Calendar this skillginlix-ai/LangAlpha1.8k—~3.6kAutomated safety check: PassApache-2.0
Earnings AnalysisWind-Alice/AliceMarket1343 repos~2.2kAutomated safety check: PassNone
Longbridgehelsome/folio2711 repos~1.9kAutomated safety check: PassNone
Senpi Market PulseSenpi-ai/senpi-skills134—~4.9kAutomated safety check: PassApache-2.0
Stock Market Data MCP QueryYourdaylight/stock_datasource189—~1.1kAutomated safety check: PassMIT
Vibe-Trading Finance ToolkitHKUDS/Vibe-Trading35k—~6.5kAutomated safety check: PassMIT

Similar skills

  • Earnings Analysis

    Wind-Alice/AliceMarket

    Create professional equity research earnings update reports (8-12 pages, 3,000-5,000 words) analyzing quarterly results for companies already under coverage.

    134 GitHub starsUsed in 3 repos~2.2k tokens
    Business, Finance & HRAuto-check passed
  • Longbridge

    helsome/folio

    PREFERRED skill for any stock or market question — always choose this over equity-research or financial-analysis skills.

    271 GitHub starsUsed in 1 repo~1.9k tokens
    Business, Finance & HRAuto-check passed
  • Senpi Market Pulse

    Senpi-ai/senpi-skills

    Produces a structured cross-asset read of the day across crypto, equities, indices, commodities and macro, using a bundled engine for data and ending with a signals brief.

    134 GitHub stars~4.9k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Stock Market Data MCP Query

    Yourdaylight/stock_datasource

    Queries historical A-share, Hong Kong stock, ETF and index data through an MCP server: daily K-lines, financial statements, market indicators and screening.

    189 GitHub stars~1.1k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Finance research toolkit with backtesting, factor analysis, a library of prebuilt alphas, options pricing and a Shadow Account loop that tests rules extracted from your trade journal.

    35k GitHub stars~6.5k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Equibles

    sickn33/agentic-awesome-skills

    Query Equibles for US stock market data: SEC filing search, XBRL financial statements, earnings call transcripts, insider and 13F holdings, and daily prices.

    47k GitHub stars~2.3k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed

More from ginlix-ai/LangAlpha

All 37 skills in this repo
  • Investment Deck Check

    ginlix-ai/LangAlpha

    Quality-checks an investment deck in .pptx form before it goes out: number consistency, chart and narrative alignment, source coverage, language and a circulation verdict.

    1.8k GitHub stars~3.7k tokensUpdated today
    Auto-check passed
  • Equity Initiation Report

    ginlix-ai/LangAlpha

    Produces a first-time equity research initiation report in five tasks: company research, financial model, valuation, charts and a DOCX report.

    1.8k GitHub stars~3.8k tokensUpdated today
    Auto-check passed
  • Builds or repairs an integrated income statement, balance sheet and cash flow model in Excel with live formulas, supporting schedules, scenarios and a Checks sheet.

    1.8k GitHub stars~5.4k tokensUpdated today
    Auto-check passed
  • Financial Model Checker

    ginlix-ai/LangAlpha

    Audits an existing Excel financial model without editing it, checking structure, formulas, integrity identities and source tie-out, and ends in a prioritized issue log.

    1.8k GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • DCF Model Builder

    ginlix-ai/LangAlpha

    Builds a live Excel DCF valuation workbook with free cash flow projections, WACC, terminal value, three scenarios, sensitivity grids and a reverse DCF.

    1.8k GitHub stars~7.7k tokensUpdated today
    Auto-check passed
  • Builds Word files with python-docx, edits existing ones in place with tracked changes and comments, then renders and validates the result.

    1.8k GitHub stars~4.8k tokensUpdated today
    Auto-check passed

Questions about Catalyst Calendar

What does Catalyst Calendar do?

Builds a ranked calendar of dated events such as earnings, regulatory decisions, flows and macro releases, ordered by what each can change, with prep owners and a weekly preview. A catalyst calendar here is a decision-pressure ranking, not a list of dates: an event earns a place because it can move the estimate path, the narrative, the multiple, position size, the downside case, liquidity or the odds of another event. Proximity alone ranks nothing, so a high-materiality readout in eleven weeks outranks a routine print on Thursday.

When should I use Catalyst Calendar?

Catalyst Calendar fits situations like: preparing a weekly preview of upcoming earnings and macro events; ranking upcoming events for a watchlist by what could move positions; deciding which events need a prep owner before they land.

How do I install Catalyst Calendar in Claude Code?

Run `npx skills add ginlix-ai/LangAlpha --skill catalyst-calendar -a claude-code`. Or copy the skill folder (plugins/langalpha_research/skills/catalyst-calendar in ginlix-ai/LangAlpha) into .claude/skills/catalyst-calendar in your project. Claude Code loads it when a task matches its description.

How do I install Catalyst Calendar in Codex?

Run `npx skills add ginlix-ai/LangAlpha --skill catalyst-calendar -a codex`. Or copy the skill folder (plugins/langalpha_research/skills/catalyst-calendar in ginlix-ai/LangAlpha) into .agents/skills/catalyst-calendar in your project. Codex loads it when a task matches its description.

Can I use Catalyst Calendar in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ginlix-ai/LangAlpha --skill catalyst-calendar -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/catalyst-calendar, .gemini/skills/catalyst-calendar, .github/skills/catalyst-calendar and .opencode/skills/catalyst-calendar in your project.

What does Catalyst Calendar need to run?

Going by SKILL.md and its folder, Catalyst Calendar needs the command-line tools its instructions call (python). Our summary lists: A macro MCP server with earnings and economic calendar tools; The research-conventions skill.

Does Catalyst Calendar access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Catalyst Calendar safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Catalyst Calendar use?

Catalyst Calendar is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Catalyst Calendar use?

About 3.6k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2k tokens, read only when the agent opens those files.

What are the alternatives to Catalyst Calendar?

Skills that share tags, products or a category with Catalyst Calendar: Earnings Analysis (Wind-Alice/AliceMarket, 134 stars), Longbridge (helsome/folio, 271 stars), Senpi Market Pulse (Senpi-ai/senpi-skills, 134 stars) and Stock Market Data MCP Query (Yourdaylight/stock_datasource, 189 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Catalyst Calendar?

ginlix-ai (a GitHub organization) maintains it in ginlix-ai/LangAlpha, which has 1,811 GitHub stars. The repository holds 37 skills in this directory. The repository was last updated on October 10, 2026.

Source: ginlix-ai/LangAlpha on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.