Agent skill

Smart Money Concepts Signals

by HKUDS in HKUDS/Vibe-Trading

Signal engine for Smart Money Concepts trading that reads structure breaks, fair value gaps and order blocks to output long, short or flat signals.

MITAuto-check passedBusiness, Finance & HR

Install Smart Money Concepts Signals

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

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

GitHub CLI
$ gh skill install HKUDS/Vibe-Trading smc --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/smc .claude/skills/smc && 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
smc
GitHub stars
35k
Token cost
~356 tokens
SKILL.md length
133 words
Files
4 (incl. references)
Skills in repo
89
Repo updated
First seen
Licence
MIT

At a glance

Signal engine for Smart Money Concepts trading that reads structure breaks, fair value gaps and order blocks to output long, short or flat signals.

  • Backtesting an ICT-style strategy based on structure breaks
  • SKILL.md covers Purpose, Signal Logic, Dependencies and Parameters, plus 1 more section
  • Runs Python scripts from its folder; calls pip
  • Generating long and short signals from fair value gaps and order blocks

What it does

This skill implements the Smart Money Concepts (ICT) school of price analysis as a signal engine built on the `smartmoneyconcepts` library. It treats a break of structure as a trend continuation signal, a change of character as a reversal signal, fair value gaps as likely refill targets and order blocks as zones where institutional orders concentrate.

Direction comes from a change of character, confirmed by a break of structure and filtered by fair value gaps. A long needs a bullish structure signal plus a bullish gap, a short needs the bearish equivalent, and conflicting or missing signals mean standing aside. Parameters include the swing-detection window, which defaults to 10, and whether a break must be confirmed by a closing price. The folder holds an example signal engine and two reference notes in Chinese, one on structure breaks and one on order blocks and gaps. Installation uses the `vibe-trading-ai[smc]` extra.

When your agent uses it

  • Backtesting an ICT-style strategy based on structure breaks
  • Generating long and short signals from fair value gaps and order blocks
  • Learning how a break of structure differs from a change of character on a chart

Example prompts

  • “Build a signal engine from break of structure and fair value gaps for my BTC hourly data.”
  • “Backtest the smart money signals on data/eurusd.csv with a swing length of 10.”
  • “What is the difference between a BOS and a ChoCH, and how does the signal logic use each one?”

Requirements

  • The `vibe-trading-ai[smc]` package, which provides the smartmoneyconcepts library

What it can do on your machine

Read from SKILL.md and the folder at commit e532650. 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

Smart Money Concepts Signals loads about 356 tokens when it runs, and up to ~822 if it reads all its reference files. Until then it costs about 44 tokens; SKILL.md has 133 words of instructions outside code blocks.

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

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 e532650, republished under its MIT licence (© HKUDS). 133 words, ~356 tokens.

Download SKILL.mdSave it as .claude/skills/smc/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
smc
description
Smart Money Concepts (ICT) signal engine. Uses the smartmoneyconcepts library to implement institutional-trading-school analysis of BOS, ChoCH, FVG, and order blocks (OB).
category
strategy

Smart Money Concepts

Purpose

The modern institutional trading school (ICT / Inner Circle Trader), built around the core idea of tracking the behavior of "smart money" (institutional capital):

ConceptEnglishMeaning
Break of structureBOS (Break of Structure)Trend continuation signal
Change of characterChoCH (Change of Character)Trend reversal signal
Fair value gapFVG (Fair Value Gap)Price refill target
Order blocksOrder BlocksInstitutional order concentration zones
LiquidityLiquidityStop-hunt target zones

Signal Logic

Direction from ChoCH + confirmation from BOS + filtering by FVG:

  • Long: bullish ChoCH/BOS + bullish FVG exists
  • Short: bearish ChoCH/BOS + bearish FVG exists
  • Stand aside: no structural signal or conflicting directions

Dependencies

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

Parameters

ParameterDefaultDescription
swing_length10Window for swing high/low detection
close_breakTrueWhether BOS/ChoCH requires a closing-price break

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/smc of HKUDS/Vibe-Trading.

  • SKILL.md
  • example_signal_engine.py
  • references/结构突破.md
  • references/订单块与缺口.md

Open the folder on GitHubat commit e532650

Compare with similar skills

Smart Money Concepts 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.

Smart Money Concepts Signals compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Smart Money Concepts Signals this skillHKUDS/Vibe-Trading35k—~356Automated safety check: PassMIT
Multi-Symbol Market Scannertradesdontlie/tradingview-mcp6.8k2 repos~447Automated safety check: PassCustom licence
Pine Script Development Looptradesdontlie/tradingview-mcp6.8k2 repos~617Automated safety check: PassCustom licence
CCXT Crypto Exchange Library2025Emma/vibe-coding-cn23k1 repos~4.4kAutomated safety check: PassMIT
TqSdk Trading and Datashinnytech/tqsdk-python5.1k—~2kAutomated safety check: PassApache-2.0
AI-Trader Signal PlatformHKUDS/AI-Trader23k—~8.5kAutomated safety check: PassNone

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
  • Pine Script Development Loop

    tradesdontlie/tradingview-mcp

    Runs a write, compile, fix and verify loop for TradingView Pine Script indicators and strategies, pushing code into the Pine Editor and checking it on the chart.

    6.8k GitHub starsUsed in 2 repos~617 tokens
    Business, Finance & HRAuto-check passed
  • CCXT Crypto Exchange Library

    2025Emma/vibe-coding-cn

    Reference help for the CCXT library covering crypto exchange APIs, market data, trading and order management across 150+ exchanges in JavaScript, Python and PHP.

    23k GitHub starsUsed in 1 repo~4.4k tokens
    Business, Finance & HRAuto-check passed
  • TqSdk Trading and Data

    shinnytech/tqsdk-python

    Answers TqSdk Python questions on market data, accounts, orders, margin trials, simulation and backtesting, using the library's own docs and examples.

    5.1k GitHub stars~2k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Connects an agent to the AI-Trader platform's API to publish trading signals and follow traders, routing to child skills for copy trading, trade sync and market data.

    23k GitHub stars~8.5k tokensUpdated 4 mo ago
    Business, Finance & HRAuto-check passed
  • Tushare Data

    zillionare/zillionare

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

    321 GitHub starsUsed in 2 repos~2.3k tokens
    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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    Auto-check passed

Questions about Smart Money Concepts Signals

What does Smart Money Concepts Signals do?

Signal engine for Smart Money Concepts trading that reads structure breaks, fair value gaps and order blocks to output long, short or flat signals. This skill implements the Smart Money Concepts (ICT) school of price analysis as a signal engine built on the `smartmoneyconcepts` library. It treats a break of structure as a trend continuation signal, a change of character as a reversal signal, fair value gaps as likely refill targets and order blocks as zones where institutional orders concentrate.

When should I use Smart Money Concepts Signals?

Smart Money Concepts Signals fits situations like: backtesting an ICT-style strategy based on structure breaks; generating long and short signals from fair value gaps and order blocks; learning how a break of structure differs from a change of character on a chart.

How do I install Smart Money Concepts Signals in Claude Code?

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

How do I install Smart Money Concepts Signals in Codex?

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

Can I use Smart Money Concepts 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 smc -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/smc, .gemini/skills/smc, .github/skills/smc and .opencode/skills/smc in your project.

What does Smart Money Concepts Signals need to run?

Going by SKILL.md and its folder, Smart Money Concepts Signals needs Python for the scripts in its folder and the command-line tools its instructions call (pip). Our summary lists: The `vibe-trading-ai[smc]` package, which provides the smartmoneyconcepts library.

Does Smart Money Concepts 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 Smart Money Concepts 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 Smart Money Concepts Signals use?

Smart Money Concepts 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 Smart Money Concepts Signals use?

About 356 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 466 tokens, read only when the agent opens those files.

What are the alternatives to Smart Money Concepts Signals?

Skills that share tags, products or a category with Smart Money Concepts Signals: Multi-Symbol Market Scanner (tradesdontlie/tradingview-mcp, 6.8k stars), Pine Script Development Loop (tradesdontlie/tradingview-mcp, 6.8k stars), CCXT Crypto Exchange Library (2025Emma/vibe-coding-cn, 23k stars) and TqSdk Trading and Data (shinnytech/tqsdk-python, 5.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Smart Money Concepts Signals?

HKUDS (a GitHub organization) maintains it in HKUDS/Vibe-Trading, which has 35,043 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.