seasonal

Generate long, short, or neutral signals from OHLCV data using month and weekday calendar effects.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ebrahim-sani/trading-automation --skill seasonal-ebrahim-sani
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seasonal
Source: https://github.com/ebrahim-sani/trading-automation/tree/main/vibe-trading/agent/src/skills/seasonal
Command: npx skills add https://github.com/ebrahim-sani/trading-automation --skill seasonal-ebrahim-sani

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematically captures calendar and seasonal regularities (month-of-year and day-of-week effects) to produce repeatable long/short/neutral signals from OHLCV time series so traders and researchers can evaluate or deploy time-based overlays without manual date filtering.

Core Features & Use Cases

  • Month-effect rules: specify bullish_months and bearish_months to mark long and short windows across any OHLCV series.
  • Optional weekday overlay: enable weekday effects and require dual confirmation (month + weekday) for stronger signals.
  • Combined mode & multi-symbol support: produces per-symbol pandas Series of 1 / -1 / 0 for backtesting, signal filtering, or live overlays.
  • Use Case: backtest "sell in May" or "spring rally" hypotheses by converting date rules into deterministic trade signals across your historical dataset.

Quick Start

Generate daily signals from my OHLCV DataFrame using bullish_months [1,2,3] and bearish_months [5,6,7,8,9] with the weekday overlay turned off.

Frequently Asked Questions about seasonal

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

FAQPage Schema
How do I generate time-based trading signals from OHLCV data using calendar effects?

Generate deterministic long, short, or neutral trade signals from OHLCV time series by applying configurable bullish and bearish month-of-year rules to your dataset. This approach systematically captures calendar effects without manual date filtering.

Can I require both month and weekday confirmation for seasonal trade signals?

Yes, you can enable an optional weekday overlay to require dual confirmation from both month and weekday effects. This combined mode produces stronger, filtered trading signals across your daily or higher timeframe OHLCV series.

How do I backtest the "sell in May" seasonal pattern in pandas?

Backtest seasonal hypotheses like "sell in May" by defining bearish_months and bullish_months parameters. The tool converts these date rules into per-symbol pandas Series of 1, -1, or 0 for direct use in algorithmic strategy backtesting.

Does this seasonal signal generator require a specific pandas DataFrame format?

Yes, it requires inputs as pandas DataFrames indexed by a DatetimeIndex to accurately parse month and weekday calendar effects. The OHLCV dataset should be daily or higher timeframe to properly generate time-based trading signals.

What is a calendar effect in time-series trading and how is it applied?

A calendar effect is a seasonal market regularity, such as specific months or days of week exhibiting consistent price behavior. This tool captures these regularities to produce repeatable trade signals from historical OHLCV series for algorithmic strategies.

Can I apply month-effect trading rules across multiple symbols simultaneously?

Yes, the signal generator supports multi-symbol datasets by producing per-symbol pandas Series outputs. This allows you to apply uniform bullish and bearish month rules across multiple assets for portfolio-level backtesting or live signal overlays.