seasonal

Generate calendar-based trading signals from month and weekday effects.

Updated May 5, 2026
One-click install
npx skills add https://github.com/wudye/traderAssistHK --skill seasonal-wudye
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seasonal
Source: https://github.com/wudye/traderAssistHK/tree/main/backend/src/skills/seasonal
Command: npx skills add https://github.com/wudye/traderAssistHK --skill seasonal-wudye

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you generate systematic trading signals from recurring calendar effects like month-of-year and day-of-week patterns, avoiding purely discretionary timing.

Core Features & Use Cases

  • Month Effect Signals: Mark bullish months as long (+1), bearish months as short (-1), and all other months as neutral (0).
  • Optional Day-of-Week Overlay: Apply weekday effects and require alignment between month and weekday direction before taking a position.
  • Combined Mode for Confirmation: Open long/short only when both signals agree, reducing mismatched seasonality noise.
  • Use Case: Test whether historical anomalies such as “sell in May” or “spring rally” show measurable predictive behavior for your OHLCV universe.

Quick Start

Configure bullish_months and/or bearish_months, optionally enable use_weekday with bullish_weekdays and bearish_weekdays, then run the signal engine to produce a per-bar signal series for each symbol.

Frequently Asked Questions about seasonal

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

FAQPage Schema
How do I generate trading signals from calendar effects like month-of-year?

You can generate calendar-based trading signals by mapping bullish months to long (+1) and bearish months to short (-1) positions. This approach processes OHLCV datasets indexed by a pandas DatetimeIndex to produce integer signal series for backtesting.

Can I combine day-of-week and month-of-year seasonality in a backtest?

Yes, you can enable a weekday overlay alongside month effects. The combined confirmation mode requires alignment between the month and weekday directional signals before opening a position, which helps reduce mismatched seasonality noise.

How do I test the "sell in May" anomaly using pandas time series data?

You test the "sell in May" anomaly by configuring bearish months in the signal engine and applying it to your OHLCV time series. The engine computes month and weekday values from the DatetimeIndex to output per-bar signals for research.

Does this calendar effect signal generator require specific data formats?

It requires an OHLCV dataset indexed by a pandas DatetimeIndex. You also need pandas and numpy installed for data handling. The engine extracts month (1-12) and weekday (0=Monday) values directly from the index to compute positions.

What is the difference between standalone month signals and combined mode for trading?

Standalone month signals mark bullish or bearish months directly, while combined mode adds a day-of-week overlay. Combined mode only opens long or short positions when both month and weekday signals agree, filtering out conflicting seasonal patterns.

Can I apply seasonal trading signals across multiple assets?

Yes, the signal engine supports cross-asset seasonal studies. By processing any OHLCV dataset with a DatetimeIndex, it generates per-bar integer signals for each symbol, enabling broad time-pattern feature engineering and backtesting.