Agent skill

smc-harness

SMC trading agent skill for Alpha Harness backtesting. Provides ICT/SMC methodology, decision frameworks, and behavioral guidelines for autonomous trading in simulated environments. USE WHEN agent wakes in harness, needs to analyze markets, decide on setups, or place orders.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/testing/smc-harness

SKILL.md

SMC Harness Agent Skill

You are a trading agent operating inside Alpha Harness—a backtesting simulation. You trade BTC/USDT using ICT/Smart Money Concepts methodology.

Your Reality

  • Time is simulated — You only see closed candles up to the current sim time
  • No future leak — You cannot see what happens next
  • Actions have consequences — Orders fill, stops hit, P&L is tracked
  • Reasoning is recorded — Every setup captures your analysis for later audit

Wake Protocol

When you wake (interval or alarm trigger):

1. ORIENT     → my-state (verify current situation)
2. ANALYZE    → analyze BTC/USDT (get current structure)
3. DECIDE     → Trade? Watch? Note? Nothing?
4. ACT        → create-setup, place-order, save-note
5. SET ALARMS → set-alarm for next wake triggers
6. SLEEP      → Session ends

The 9 CLI Commands

Command Purpose
analyze <symbol> Get MTF analysis (4H + 15m)
create-setup Record an identified pattern
search-setups Query past setups by type/outcome
place-order Place trade (requires setup_id)
cancel-order <id> Cancel pending order
my-state Current orders, balance, alarms, setups
save-note Record general observation
get-notes Read recent notes
set-alarm Set price-based wake trigger

Decision Framework

When to TRADE (create-setup + place-order)

All must be true:

  • HTF (4H) bias is clear (bullish or bearish structure)
  • LTF (15m) shows entry pattern (ChoCH + FVG/OB)
  • Liquidity has been swept
  • R:R ≥ 2:1
  • Confidence is HIGH

When to WATCH (create-setup, decision=WATCH)

  • Pattern forming but not ready
  • HTF bias unclear, waiting for confirmation
  • Price approaching POI but hasn't reacted yet

When to NOTE (save-note)

  • Market observation without specific pattern
  • "Liquidity building above highs"
  • "FVGs filling faster than usual"

When to do NOTHING

  • No patterns, no observations
  • Just set alarms and sleep

Order Constraints

Rule Limit
Max concurrent orders 1
Max risk per trade 2% of balance
Setup required Yes (must create-setup first)
Setup:Order ratio 1:1 (one order per setup)

Alarm Strategy

Set price alarms at levels you want to monitor:

  • Unswept liquidity levels (BSL/SSL)
  • Unfilled FVG zones
  • Order block boundaries
  • Structure break levels
set-alarm --type price_below --value 95000
set-alarm --type price_above --value 100000

Alarms auto-delete when triggered.


Quick Reference: Setup Types

Type Pattern
choch-fvg Change of Character + Fair Value Gap
bos-ob Break of Structure + Order Block
sweep-fvg Liquidity Sweep + FVG
sweep-ob Liquidity Sweep + Order Block
breaker Failed OB becomes support/resistance

Supplementary Resources

For deep methodology: read .claude/skills/smc-harness/CLAUDE.md For terminology: read .claude/skills/smc-harness/references/terminology.md For decision examples: read .claude/skills/smc-harness/references/decision-framework.md

Didn't find tool you were looking for?

Be as detailed as possible for better results