- name
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add staskh/trading_skills --skill ib-trailing-stop -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add staskh/trading_skills --skill ib-trailing-stop -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add staskh/trading_skills --skill ib-trailing-stop -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add staskh/trading_skills --skill ib-trailing-stop -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/staskh/trading_skills/tree/HEAD/.claude/skills/ib-trailing-stopFrom the publisher
Places IB native TRAIL orders against stocks and naked LEAPS in the portfolio. IB auto-adjusts the stop trigger as the price climbs and locks it as price falls.
PMCC positions are intentionally excluded — use ib-stop-loss for those (a standalone
trailing stop on the PMCC long leg would break the hedge at trigger).
Default mode is dry-run — no orders are placed unless --execute is in the request.
TWS or IB Gateway must be running locally with API enabled:
IB_PORT env var — default port when --port is omitted (e.g. IB_PORT=4001 for a Gateway container). Precedence: --port flag > IB_PORT > built-in default. Set it in the shell or a .env file.Port fallback: If the configured port fails, automatically retry on the other port. If the retry succeeds, save to memory which account type worked (live/paper) and reuse it for all IB skill calls in this and future sessions — until the user explicitly asks for the other account. If both ports fail, ask the user to verify that TWS or IB Gateway is running with API access enabled.
Dry-run (default — no orders placed):
uv run python .claude/skills/ib-trailing-stop/scripts/trailing_stop.py --symbols JOBY --trail-pct 20
Execute (cancel orphan TS_ orders + place new TS_ TRAIL orders):
uv run python .claude/skills/ib-trailing-stop/scripts/trailing_stop.py --symbols JOBY --trail-pct 20 --execute
Execute forced (cancel + replace existing TS_ orders with current parameters):
uv run python .claude/skills/ib-trailing-stop/scripts/trailing_stop.py --execute --forced
Format JSON output as a markdown report with three sections:
Show all_trail_orders.module (TS_ orders) and all_trail_orders.manual (manually placed).
If orphan_orders is non-empty, warn that these were cancelled (execute mode) or need manual cancellation (dry-run).
For each entry in positions, show a table:
For LEAPS rows, also show the option leg (strike/expiry) and current option mark.
action values:
place_new — no existing TS_ order; one will be created in execute modepreserve_existing — TS_ already in place; left alone (IB has been tracking the high)overwrite — --forced is on; existing TS_ will be cancelled and replacedPer-position result with order_id and order_ref.
action: place_new (these are about to get a new TRAIL).preserve_existing separately so user knows nothing changed.trail_stop_price) so user knows where IB has trailed to.{
"generated_at": "2026-05-29 10:00 ET",
"data_delay": "real-time",
"dry_run": true,
"forced": false,
"trail_pct": 20.0,
"trail_amt": null,
"accounts": ["U1234567"],
"symbols_filter": ["JOBY"],
"all_trail_orders": {"module": [], "manual": []},
"orphan_orders": [],
"positions": [
{
"symbol": "JOBY",
"type": "stock",
"account": "U1234567",
"qty": 1000,
"underlying_price": 7.50,
"stock": {
"avg_cost": 5.00,
"current_price": 7.50
},
"trail_stop": {
"trail_pct": 20.0,
"trail_amt": null,
"reference": 7.50,
"initial_stop_price": 6.00,
"action": "place_new",
"existing_trail": null
}
}
]
}
max(current_price, avg_cost) — locks in profit when above cost, never starts below entry.current_price as the reference (can place an initial stop below entry, useful when re-arming after a drawdown).--forced to deliberately reset.ib-stop-loss for those.TS_{SYM}_{STRIKE}_{EXPIRY}_{RIGHT} — naked LEAPS TRAIL orders (right is C or P so calls and puts on the same strike/expiry don't collide)TS_{SYM}_STK — stock TRAIL ordersAll analytics live in src/trading_skills/broker/trailing_stop.py:
Analytics (no IBKR — testable in isolation):
calc_trail_reference — max(current_price, avg_cost) normally; current_price if forcedcalc_initial_trail_stop_price — reference × (1 − trail_pct/100) or reference − trail_amtidentify_trailable_positions — stocks + naked LEAPS; PMCC excludedbuild_trail_analysis — full per-position output dictdetect_orphan_trail_orders — TS_ TRAIL orders for gone positionssummarize_all_trail_orders — splits IB TRAIL orders into module vs manualData layer (IBKR):
get_trailing_stop_data — main entry point_cancel_orphan_orders — cancel stale TS_ orders_place_simple_trail_order — native TRAIL order on stock or option_execute_position_trail — dispatch per position typeServer-side trailing stop management for stocks and naked LEAPS in IB. Places native TRAIL orders that auto-ratchet the stop as price climbs. Dry-run by default. Requires TWS or IB Gateway running loc
---name: ib-trailing-stopdescription: Server-side trailing stop management for stocks and naked LEAPS in IB. Places native TRAIL orders that…---# .claude/skills/ib-trailing-stop/SKILL.mdOverview
Server-side trailing stop management for stocks and naked LEAPS in IB. Places native TRAIL orders that auto-ratchet the stop as price climbs. Dry-run by default. Requires TWS or IB Gateway running locally.
FAQ
Download .claude/skills/ib-trailing-stop/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/staskh/trading_skills.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.