agentleFS
SKE-LabsSKE-Labs/agent-trading-skills/skills/ict-smart-money/fair-value-gaps/SKILL.md

fair-value-gaps

Skill17 starsChanged 4 months agoApache-2.0View on GitHub

Detect and test three-candle fair-value-gap zones. Use when the user wants an objective wick-gap definition, retracement statistics, entry, invalidation, and cost-aware validation.

1 other project uses a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Identify FVG: after impulsive move using candle data:

    line 36
  2. Distinctive:

    Treat the setup as a testable hypothesis, not a prediction.

    line 52
  3. Distinctive:

    Test stacked gaps and higher-timeframe alignment rather than assuming directional strength.

    line 62

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Fair Value Gaps (FVG) Trading

A three-candle wick-gap convention. The pattern is observable in OHLC data; calling it inefficiency or institutional imbalance requires separate order-book/trade evidence.

Identification

Bullish FVG

  1. Strong bullish middle candle
  2. Gap between Candle 1 high and Candle 3 low
  3. Zone = the unfilled gap area

Bearish FVG

  1. Strong bearish middle candle
  2. Gap between Candle 1 low and Candle 3 high
  3. Zone = the unfilled gap area

Quality Factors

  • Normalize gap size by ATR, spread, and middle-candle range.
  • Record preceding swing/sweep, time-of-day relative volume, and higher-timeframe state as features.
  • Calibrate thresholds and interactions; do not convert them into untested quality labels.

Workflow

  1. Identify FVG after impulsive move using candle data:
    get_candles_around_date(symbol=<symbol>, exchange=<exchange>, interval=<interval>, date=<date>)
  2. Mark the zone using draw_chart_analysis with type demand (bullish) or supply (bearish)
  3. Wait for retracement into the gap
  4. Choose an entry rule — near boundary, midpoint, full traversal, or price confirmation; select in training data only
  5. Stop loss beyond the full FVG boundary
  6. Target the high/low of the impulse move

FVG + Order Block Confluence

Record overlap with a separately defined order-block zone and test whether it adds value over FVG alone; the labels are correlated price-derived features.

Evidence and Validation

  • Treat the setup as a testable hypothesis, not a prediction. Define thresholds, entry, invalidation, and exit before evaluating outcomes.
  • Calibrate on the same instrument, venue, session, and timeframe. Use closed candles and a held-out or walk-forward sample; record every variant tried.
  • Include spread, fees, slippage, borrow or funding, partial fills, and latency. Reject the setup when net expectancy is not positive or depends on one narrow parameter.
  • Return observed inputs, missing data, cost assumptions, entry, invalidation, exit, and a valid, watch, or no-trade status.
  • Research basis: The three-candle definition follows the ICT convention, but independent market-microstructure research links price changes to observable order-flow imbalance and depth—not to guaranteed gap fills.

Key Rules

  • Estimate touch and fill rates with a fixed horizon and competing-risk rule; do not call gaps magnets.
  • Expire zones after a predeclared time and retain unfilled zones in the denominator.
  • Test stacked gaps and higher-timeframe alignment rather than assuming directional strength.
  • The midpoint is a coordinate, not an empirically privileged entry.

Related Skills

  • order-blocks — test overlap between two explicitly defined candle-zone conventions
  • premium-discount — Enter FVGs in discount for longs, premium for shorts

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.