Agent skill

Harmonic Pattern Signals

by HKUDS in HKUDS/Vibe-Trading

“Harmonic Patterns signal engine. Identifies XABCD five-point structures such as Gartley/Bat/Butterfly/Crab based on Fibonacci geometry, and generates trading signals in the PRZ…”

— description from SKILL.md by HKUDS
MITAuto-check passedBusiness, Finance & HR

Install Harmonic Pattern Signals

skills CLI
$ npx skills add HKUDS/Vibe-Trading --skill harmonic -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install HKUDS/Vibe-Trading harmonic --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agent/src/skills/harmonic .claude/skills/harmonic && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
harmonic
GitHub stars
35k
Token cost
~355 tokens
SKILL.md length
135 words
Files
4 (incl. references)
Skills in repo
89
Repo updated
First seen
Licence
MIT

At a glance

  • SKILL.md covers Purpose, Core Concepts, Dependencies and Parameters, plus 1 more section
  • Runs Python scripts from its folder; calls pip

About this skill

“Harmonic Patterns signal engine. Identifies XABCD five-point structures such as Gartley/Bat/Butterfly/Crab based on Fibonacci geometry, and generates trading signals in the PRZ (Potential Reversal Zone).”

— description from SKILL.md by HKUDS

Harmonic Pattern Signals is a skill in HKUDS/Vibe-Trading (35k stars). Its SKILL.md is about 355 tokens, with 3 other files in the folder (references). Licence: MIT.

What it can do on your machine

Read from SKILL.md and the folder at commit 14cabaf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Harmonic Pattern Signals loads about 355 tokens when it runs, and up to ~754 if it reads all its reference files. Until then it costs about 53 tokens; SKILL.md has 135 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~53
When it runs · the whole SKILL.md, loaded when a task matches
~355
With references · SKILL.md plus every file in references/, read only if the agent opens them
~754

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from HKUDS/Vibe-Trading at commit 14cabaf, republished under its MIT licence (© HKUDS). 135 words, ~355 tokens.

Download SKILL.mdSave it as .claude/skills/harmonic/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
harmonic
description
Harmonic Patterns signal engine. Identifies XABCD five-point structures such as Gartley/Bat/Butterfly/Crab based on Fibonacci geometry, and generates trading signals in the PRZ (Potential Reversal Zone).
category
strategy

Harmonic Patterns

Purpose

The Fibonacci geometry school uses precise ratio relationships to identify price patterns:

PatternB-Point RetracementD-Point RetracementDirection
Gartley0.618 XA0.786 XAReversal
Bat0.382-0.5 XA0.886 XAReversal
Butterfly0.786 XA1.27 XAReversal
Crab0.382-0.618 XA1.618 XAReversal

Core Concepts

  • XABCD five-point pattern: a price structure defined by precise Fibonacci ratios
  • PRZ (Potential Reversal Zone): the convergence area around point D, where reversal probability is high
  • Bullish pattern (point D at the bottom) → buy signal
  • Bearish pattern (point D at the top) → sell signal

Dependencies

bash
pip install "vibe-trading-ai[harmonic]"

pyharmonics is optional. If the extra is not installed, the example signal engine falls back to the bundled detector.

Parameters

ParameterDefaultDescription
is_stockFalseWhether the instrument is a stock (affects analysis parameters)

Signal Convention

  • 1 = long, -1 = short, 0 = stand aside

© HKUDS, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in agent/src/skills/harmonic of HKUDS/Vibe-Trading.

  • SKILL.md
  • example_signal_engine.py
  • references/PRZ交易.md
  • references/XABCD形态.md

Open the folder on GitHubat commit 14cabaf

Compare with similar skills

Harmonic Pattern Signals next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Harmonic Pattern Signals compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Harmonic Pattern Signals this skillHKUDS/Vibe-Trading35k—~355Automated safety check: PassMIT
Multi-Symbol Market Scannertradesdontlie/tradingview-mcp6.8k2 repos~447Automated safety check: PassCustom licence
Tushare Datazillionare/zillionare3192 repos~2.3kAutomated safety check: PassNone
Tradingview MCPatilaahmettaner/tradingview-mcp5k—~1.3kAutomated safety check: PassMIT
Digital Oraclekomako-workshop/digital-oracle870—~5.9kAutomated safety check: PassMIT
TradingView Replay Practicetradesdontlie/tradingview-mcp6.8k2 repos~446Automated safety check: PassCustom licence

Similar skills

  • Multi-Symbol Market Scanner

    tradesdontlie/tradingview-mcp

    Scans a list of trading symbols in TradingView for setups, patterns or strategy results and reports them as a ranked comparison table.

    6.8k GitHub starsUsed in 2 repos~447 tokens
    Business, Finance & HRAuto-check passed
  • Tushare Data

    zillionare/zillionare

    面向中文自然语言的 Tushare 数据研究技能。用于把“看看这只股票最近怎么样”“帮我查财报趋势”“最近哪个板块最强”“北向资金在买什么”“给我导出一份行情数据”这类请求,转成可执行的数据获取、清洗、对比、筛选、导出与简要分析流程。适用于 A 股、指数、ETF/基金、财务、估值、资金流、公告新闻、板块概念与宏观数据等研究场景。

    319 GitHub starsUsed in 2 repos~2.3k tokens
    Business, Finance & HRAuto-check passed
  • Tradingview MCP

    atilaahmettaner/tradingview-mcp

    AI Trading Intelligence — live prices, 30+ technical indicators, backtesting (6 strategies), walk-forward overfitting detection, trade logs, equity curves, licensed news sentiment (Marketaux), and…

    5k GitHub stars~1.3k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Digital Oracle

    komako-workshop/digital-oracle

    Answer prediction questions using market trading data, not opinions.

    870 GitHub stars~5.9k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • TradingView Replay Practice

    tradesdontlie/tradingview-mcp

    Guides a manual practice session in TradingView replay mode: set a chart, step through historical bars, take trades and review the P&L.

    6.8k GitHub starsUsed in 2 repos~446 tokens
    Business, Finance & HRAuto-check passed
  • WorldQuant BRAIN Alpha Research

    QuantML-Research/wq-alpha-research

    Chinese-language playbook for WorldQuant BRAIN alphas: choose fields, write expressions, backtest, diagnose check failures, tune turnover, submit and build portfolios.

    405 GitHub stars~4.9k tokensUpdated 3 mo ago
    Business, Finance & HRAuto-check passed

More from HKUDS/Vibe-Trading

All 89 skills in this repo
  • Eastmoney Market Data

    HKUDS/Vibe-Trading

    Index of Eastmoney's free, no-token market data interfaces for China A-shares and Hong Kong stocks: fund flows, dragon-tiger lists, margin trading, reports and news.

    35k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • OKX Market Data

    HKUDS/Vibe-Trading

    Retrieves public OKX cryptocurrency market data such as spot prices, candlesticks, funding rates and open interest through the OKX V5 REST API, with no authentication.

    35k GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • SEC EDGAR Filings Fetcher

    HKUDS/Vibe-Trading

    Fetches U.S. SEC EDGAR data: resolves tickers to CIK numbers, lists recent 10-K, 10-Q and 8-K filings with document URLs, and pulls XBRL financial series.

    35k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • A-Share ST Risk Screener

    HKUDS/Vibe-Trading

    Predicts whether a mainland China A-share company risks an ST or *ST warning after its next annual report, using financial thresholds and Sina penalty records.

    35k GitHub stars~4.9k tokensUpdated today
    Auto-check passed
  • Breaks a structural trend such as AI infrastructure into its physical supply chain and ranks lesser-known listed companies sitting on each bottleneck.

    35k GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Plans and drafts an eight-part, roughly 120k-word investigative series on one company, built around a strict fact-check pass rather than fast drafting.

    35k GitHub stars~2.4k tokensUpdated today
    Auto-check passed

Questions about Harmonic Pattern Signals

How do I install Harmonic Pattern Signals in Claude Code?

Run `npx skills add HKUDS/Vibe-Trading --skill harmonic -a claude-code`. Or copy the skill folder (agent/src/skills/harmonic in HKUDS/Vibe-Trading) into .claude/skills/harmonic in your project. Claude Code loads it when a task matches its description.

How do I install Harmonic Pattern Signals in Codex?

Run `npx skills add HKUDS/Vibe-Trading --skill harmonic -a codex`. Or copy the skill folder (agent/src/skills/harmonic in HKUDS/Vibe-Trading) into .agents/skills/harmonic in your project. Codex loads it when a task matches its description.

Can I use Harmonic Pattern Signals in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HKUDS/Vibe-Trading --skill harmonic -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/harmonic, .gemini/skills/harmonic, .github/skills/harmonic and .opencode/skills/harmonic in your project.

What does Harmonic Pattern Signals need to run?

Going by SKILL.md and its folder, Harmonic Pattern Signals needs Python for the scripts in its folder and the command-line tools its instructions call (pip).

Does Harmonic Pattern Signals access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Harmonic Pattern Signals safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Harmonic Pattern Signals use?

Harmonic Pattern Signals is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Harmonic Pattern Signals use?

About 355 tokens (SKILL.md is roughly 1.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 399 tokens, read only when the agent opens those files.

What are the alternatives to Harmonic Pattern Signals?

Skills that share tags, products or a category with Harmonic Pattern Signals: Multi-Symbol Market Scanner (tradesdontlie/tradingview-mcp, 6.8k stars), Tushare Data (zillionare/zillionare, 319 stars), Tradingview MCP (atilaahmettaner/tradingview-mcp, 5k stars) and Digital Oracle (komako-workshop/digital-oracle, 870 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Harmonic Pattern Signals?

HKUDS (a GitHub organization) maintains it in HKUDS/Vibe-Trading, which has 34,949 GitHub stars. The repository holds 89 skills in this directory. The repository was last updated on October 8, 2026.

Source: HKUDS/Vibe-Trading on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.