harmonic

Detect XABCD harmonic patterns and generate trading signals at the PRZ from OHLCV data.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automatically detects XABCD harmonic patterns and identifies the Potential Reversal Zone (PRZ) to surface high-probability reversal signals, removing the need for manual visual scanning of price charts.

Core Features & Use Cases

  • Multiple pattern support: Detects Gartley, Bat, Butterfly, and Crab patterns using Fibonacci ratio checks.
  • Flexible backends: Prefers the pyharmonics library when available and falls back to a built-in swing-based detector with configurable tolerance and window settings.
  • Signal output: Emits discrete signals at the D (PRZ) timestamp where 1 = long, -1 = short, and 0 = stand aside for downstream execution, journaling, or backtesting.
  • Use Case: Use daily OHLCV data for BTC-USDT to generate entry signals at PRZ for automated execution or to log high-probability reversal events in a trading journal.

Quick Start

Generate trading signals for BTC-USDT using daily OHLCV data and output a timestamp-indexed Series of 1 for buy, -1 for sell, and 0 for no signal.

Frequently Asked Questions about harmonic

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

FAQPage Schema
How do I detect harmonic patterns like Gartley, Bat, Butterfly, and Crab in OHLCV data?▼

To detect harmonic patterns such as Gartley, Bat, Butterfly, and Crab, supply an OHLCV DataFrame with a datetime index and open/high/low/close columns. The Skill identifies XABCD structures and outputs reversal signals at the Potential Reversal Zone (PRZ).

What trading signals are generated at the PRZ for harmonic patterns?▼

At the PRZ timestamp, trading signals are emitted as a Series where 1 indicates a long entry, -1 indicates a short entry, and 0 means stand aside. These discrete signals are suitable for downstream execution, journaling, or backtesting.

Can I use pyharmonics for pattern detection without installing it as a mandatory dependency?▼

No mandatory installation is needed. The Skill prefers the pyharmonics library when available but automatically falls back to a built-in swing-based detector with configurable tolerance and window settings if the dependency is missing.

Does harmonic pattern detection work for crypto, forex, and equities markets?▼

Yes, harmonic pattern detection applies to crypto, forex, and equities markets. It processes OHLCV time-series data across these asset classes in both backtesting and live monitoring scenarios to identify XABCD reversal structures.

What DataFrame format is required to scan for XABCD harmonic patterns?▼

A pandas DataFrame with a datetime index and open, high, low, and close columns is required. This OHLCV format allows the swing-based detector and Fibonacci ratio checks to identify valid Gartley, Bat, Butterfly, and Crab structures.