harmonic

Detect Fibonacci XABCD harmonic patterns and generate D-point trading signals from OHLCV data.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyharmonics, pandas, numpy, requests, and includes references (resource) components.

What problem does it solve?

This Skill helps you identify XABCD harmonic patterns (Gartley, Bat, Butterfly, Crab) and translate their D-point convergence into actionable long/short/flat trading signals.

Core Features & Use Cases

  • Fibonacci XABCD pattern detection: Finds Gartley/Bat/Butterfly/Crab candidates by validating Fibonacci ratio constraints on swing points.
  • PRZ-oriented signaling at point D: Emits signals specifically at the D-point where Potential Reversal Zone (PRZ) convergence is expected.
  • Dual detection backend (with fallback): Uses pyharmonics when available, otherwise falls back to a built-in swing-point enumerator and ratio classifier.

Use case example: Analyze daily OHLCV for BTC/ETH to mark historical dates where harmonic patterns complete at PRZ, producing a time-aligned signal series (1 for long, -1 for short, 0 to stand aside) for backtesting.

Quick Start

Use the harmonic signal engine to generate PRZ-based buy/sell signals from a map of symbols to OHLCV DataFrames indexed by datetime.

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 from OHLCV price data?

Harmonic patterns are identified by validating Fibonacci ratio constraints on XABCD swing points extracted from OHLCV price series. This Skill classifies Gartley, Bat, Butterfly, and Crab formations and outputs a time-aligned signal series for backtesting.

How do I generate trading signals at the PRZ completion point?

Trading signals are generated at the D-point where Potential Reversal Zone (PRZ) convergence is expected. This Skill processes OHLCV inputs to emit per-timestamp signals using 1 for long, -1 for short, and 0 for stand aside.

Can I use pyharmonics for backtesting crypto pairs and stocks?

Yes, this Skill applies pyharmonics to detect harmonic patterns for backtesting across instruments like crypto pairs or stocks. It processes historical OHLCV charts and includes a built-in deterministic fallback detector if pyharmonics is unavailable.

What is the best way to scan historical charts for Fibonacci retracement patterns?

Scanning historical charts for Fibonacci retracement patterns is done by processing OHLCV DataFrames indexed by datetime. This Skill validates Fibonacci ratio tolerances on swing points to classify XABCD harmonic patterns and output actionable signals.

Do I need pandas and numpy to run harmonic pattern detection?

Yes, pandas and numpy are required dependencies for handling OHLCV DataFrames and numerical operations during harmonic pattern detection. The Skill also uses requests for data fetching and pyharmonics, with a deterministic fallback if the latter is missing.