price-action

Price action market structure analysis, trend vs trading range classification, Always In directional framework, buying/selling pressure analysis, market cycle phase identification, the price action me

SKILL.md

GitHub

Methodology inspired by publicly taught price action trading frameworks; all text is an original paraphrase.

Defaults

Parameter Default Value Rationale
trend_confirmation_bars 3 Minimum consecutive bars for trend confirmation
trading_range_threshold 20 bars Pullback > 20 bars becomes a full Trading Range
reversal_failure_rate 80% In a trending market, ~80% of reversal attempts fail and become flags
inertia_rule 60-40 60% probability trend continues, 40% probability reversal

Preflight

Run canonical pre-flight per contracts/preflight.md. Include the X-Agentii-Trace header on every tool call per contracts/x-agentii-trace-header.md — carry the _run_id from your first tool result and name yourself (and your parent, if you were spawned).

Data Source Priority

  1. Price action framework — references/market-structure.md (bundled market structure methodology)
  2. Real-time price data — get_realtime_quote for OHLCV and VIX context
  3. Technical setups — search_technical_setups for matching pattern setups

Methodology

Retrieval Scope

structured_only

Retrieval Strategy

This skill follows Branch (d) Simple Lookup from contracts/retrieval.md: the methodology framework is bundled in references/market-structure.md. Real-time price data supplements via get_realtime_quote. Matched technical setups via search_technical_setups(market_condition=...). No unstructured document retrieval.

Temporal Scope

See frontmatter temporal_scope block.

Tool Allowlist

See frontmatter allowed_tools.

Protocol

This skill implements the price action trading framework: market structure analysis using price action alone — no indicators except a 20-bar EMA. The core thesis: every market is always in one of two states — Trend or Trading Range. If uncertain, it is a Trading Range. Detailed methodology, definitions, and decision rules are in references/market-structure.md.

Step 1 — Macro Context (Mode C — degrade-gracefully)

Assess the broader market environment before analyzing individual setups.

  1. Query get_realtime_quote for a broad market proxy (SPY/SPX) to assess VIX levels.
  2. Determine the macro regime from upstream analysis (expansion/contraction/stagflation/recovery).
  3. VIX assessment: elevated (> 25) → tighten position sizing, favor defined-risk setups. Low (< 15) → standard sizing.

Step 2 — Market Structure Identification

Answer the most important question in price action: Trend or Trading Range?

  1. Cycle Phase Identification:
    • Trend = Series of higher highs/lows (bull) or lower highs/lows (bear). Contains breakout→channel sub-phases.
    • Trading Range = Sideways movement. ≥ 20 bars = full TR. < 20 bars within a trend = Pullback.
    • Reversal Signal = Trading Range at a trend extreme that transitions into opposite trend.
  2. Trend Strength Classification:
    • Strong Trend (Breakout/Spike): Big bodies, small tails, consecutive bars with little overlap.
    • Weak Trend (Channel): Bars with visible tails and overlap, contained between two parallel lines.
  3. Pullback vs Trading Range Rule:
    • Pullback = < 20 bars pause; breakout likely in trend direction.
    • Trading Range = ≥ 20 bars; direction lost; breakout equally likely either way.
    • Fractal check: what appears as a pullback on this timeframe may be a trading range on a lower timeframe.

Step 3 — Directional Bias

Determine the directional bias using the Always In framework.

  1. Ask: "If forced to enter the market right now, long or short?" Your answer = Always In direction.
  2. If unclear: the market is in a Trading Range. Confusion = hallmark of TR.
  3. Directional bias rules:
    • Always In Long → only consider long setups; ignore short signals even if they look strong.
    • Always In Short → only consider short setups; ignore long signals.
    • No clear Always In → Trading Range mode: Buy Low, Sell High, scalp only.

Step 4 — Pressure Analysis

Identify which side (bulls/bears) is applying dominant pressure.

  1. Bar-by-bar assessment:
    • Close near high = bulls dominated through bar's life.
    • Close near low = bears dominated.
    • Long tail above = bears aggressively sold higher prices → failed breakout upward.
    • Long tail below = bulls aggressively bought lower prices → failed breakout downward.
  2. Every tail is a failed breakout — it was once a strong trend body that got reversed. Tails signal the failure of one side.
  3. Context override: A small body in a strong trend behaves as a trend bar. A big body in a sideways market behaves as a trading range bar. Context always overrides individual bar appearance.

Step 5 — Momentum Assessment

Assess momentum using the 20-60 day framework: Technical Analysis (patterns/formations) provides the big picture over weeks to months. Price Action (momentum) provides the near-term directional signal over days to weeks. Both must align for a trade to have favorable timing.

  1. RSI (Relative Strength Index) — 14-day and 20-day:

    • Above 70 = overbought; below 30 = oversold.
    • RSI reversing from overbought = momentum fading from the upward move.
    • Avoid entering longs when RSI is overbought and falling; avoid shorts when RSI is oversold and rising.
    • Treat "overbought" and "oversold" with caution: a strong trend can stay overbought/oversold for extended periods.
  2. Moving Averages — SMA and EMA at 20, 60, 120, and 250 periods:

    • Price above rising MA = bullish momentum confirmed.
    • Price below falling MA = bearish momentum confirmed.
    • MA convergence/flattening = momentum weakening, potential transition.
  3. MACD (Moving Average Convergence Divergence):

    • Standard: (12, 26, 9). Extended: (20, 60, 10) and (20, 60, 20) for longer timeframes.
    • MACD line crossing above signal line = bullish momentum shift.
    • MACD line crossing below signal line = bearish momentum shift.
    • Divergence between MACD and price = potential reversal signal.
  4. Heikin Ashi Candles: Use for smoothing price action and identifying sustained momentum. Consecutive Heikin Ashi bars without lower shadows = strong bull momentum. Without upper shadows = strong bear momentum.

  5. Timing Assessment (Traffic-Light System):

    • Green: Market structure + momentum + Always In direction all aligned → favorable entry timing.
    • Amber: Partial alignment, some conflicting signals → caution; reduce position size or wait.
    • Red: Conflicting signals across structure/momentum/direction → do not enter; wait for clearer conditions.

Step 6 — Setup Context Handoff

Produce the market structure output to be consumed by downstream skills.

  1. Output classification:
    • market_condition: trending_up / trending_down / ranging
    • trend_strength: strong / weak / none
    • always_in_direction: long / short / neutral
    • cycle_phase: breakout / channel / trading_range / reversal
  2. Handoff to chart-patterns: The context above determines which patterns are valid. In a strong bull trend, only long patterns are valid — all short patterns are ignored regardless of how strong they appear.
  3. MCP retrieval: search_technical_setups(market_condition=<derived>) for rough matching against gold.technical_setups.

Output File

{ticker}/{YYYY-MM-DD_HHMM}_price-action_{affix}.md

Output Structure

  1. Executive Summary — Market state (Trend/TR), Always In direction, cycle phase with confidence level
  2. Market Structure Analysis — Trend strength, cycle phase, pullback vs trading range classification with specific bar counts
  3. Always In Assessment — Directional bias, rationale, confidence level
  4. Pressure Analysis — Bull/bear dominance assessment, key tail/bodie signals on recent bars
  5. Transition Signals — Early warning signals of cycle phase change (channel flattening, TR forming at extreme)
  6. Pattern Context — Valid pattern directions for downstream chart-patterns skill
  7. Coverage Gaps — Data limitations and degraded-mode annotations

Error Handling

Error Fallback
No price data available Proceed with static market structure principles; flag degraded
search_technical_setups unreachable Skip MCP step; provide manual pattern analysis
Ambiguous market state Classify as Trading Range; note ambiguity

Memory Load

See contracts/memory-load.md.

Snapshot

See contracts/snapshot-synthesis.md.

Final Summary (TUI)

Include ### Key Citations block with 0-10 clickable /v/ URLs.

References

  • references/market-structure.md
  • contracts/citation-and-memory.md
  • contracts/output-frontmatter-schema.md
  • contracts/memory-load.md
  • contracts/snapshot-synthesis.md
  • contracts/preflight.md
  • contracts/retrieval.md