catalyst-event-gate

Gate directional trading strategies around upcoming earnings and macro events.

2|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/k1064190/stock-expectation --skill catalyst-event-gate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: catalyst-event-gate
Source: https://github.com/k1064190/stock-expectation/tree/main/.claude/skills/catalyst-event-gate
Command: npx skills add https://github.com/k1064190/stock-expectation --skill catalyst-event-gate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires fmp, yfinance, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill mitigates the risk of market volatility by providing a timeline of upcoming earnings reports and macro events, and gates directional trading strategies around these events.

Core Features & Use Cases

  • Earnings Timeline: Consolidates forward earnings reports into a single timeline for each ticker.
  • Macro Event Timeline: Includes high-impact macro releases like FOMC, CPI, and NFP.
  • R3 Event-Risk Gate: Triggers alerts when earnings or macro events are imminent, allowing traders to adjust their strategies accordingly.
  • Use Case: Before entering a trade, you can use this Skill to check the upcoming earnings report and macro events to avoid trading close to volatile periods.

Quick Start

Check the earnings and macro event timeline for NVDA using the 'catalyst timeline' command.

Frequently Asked Questions about catalyst-event-gate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check upcoming earnings and macro events before entering a trade?

You can avoid trading close to volatile periods by using the R3 event-risk gate, which triggers alerts when earnings or macro events are imminent, allowing you to adjust directional trading strategies accordingly.

What macro events are tracked for event risk management in US and Korean markets?

Event risk management tracks high-impact macro releases like FOMC, CPI, and NFP, consolidating them into a timeline alongside forward earnings reports to help you manage market volatility for US and Korean markets.

Do I need FMP and yfinance access to track earnings calendars and economic events?

Yes, you need access to FMP earnings calendar and economic calendar for full functionality, as the Skill requires both FMP and yfinance dependencies to provide the complete timeline of upcoming earnings reports and macro events.

How does the R3 event-risk gate adjust directional trading strategies around earnings?

The R3 event-risk gate triggers alerts when earnings or macro events are imminent, allowing traders to gate directional trading strategies by adjusting or pausing trades close to volatile periods before entering a position.

Can I consolidate multiple ticker earnings timelines into a single macro event view?

Yes, the earnings timeline consolidates forward earnings reports into a single timeline for each ticker, while the macro event timeline includes high-impact macro releases to provide a comprehensive view of upcoming event risks.

When should I avoid entering directional trades due to imminent market volatility?

You should avoid entering directional trades when the R3 event-risk gate triggers alerts for imminent earnings reports or high-impact macro events, indicating periods of high market volatility where strategies should be adjusted.