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.