- name
SKILL.md
技能檔案保留在發布者的儲存庫中。
在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add staskh/trading_skills --skill ib-find-short-roll -a cursor -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add staskh/trading_skills --skill ib-find-short-roll -a claude-code -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add staskh/trading_skills --skill ib-find-short-roll -a codex -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add staskh/trading_skills --skill ib-find-short-roll -a grok -y在 Grok Bot 聊天中傳送複製的訊息。Bot 會從 GitHub 取得這個 SKILL.md,並加入你所有 Bot 共用的技能中。
Install this skill: https://github.com/staskh/trading_skills/tree/HEAD/.claude/skills/ib-find-short-roll來自發布者
Analyze roll options for short positions or find best short options to open against long stock using real-time data from Interactive Brokers.
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.
Note: If
uvis not installed orpyproject.tomlis not found, replaceuv run pythonwithpythonin all commands below.
uv run python scripts/roll.py SYMBOL [--strike STRIKE] [--expiry YYYYMMDD] [--right C|P] [--port PORT] [--account ACCOUNT] [--iv-multiplier N]
The script returns JSON to stdout with all position and candidate data.
Read templates/markdown-template.md for formatting instructions. Generate a markdown report from the JSON data and save to sandbox/.
Present key findings to the user: recommended position, credit/debit, and the saved report path.
mode: "roll"): Analyzes roll candidates to different expirations/strikesmode: "spread"): Finds best short call/put to create a vertical spreadmode: "new_short"): Finds best covered call (or protective put) to openSYMBOL - Ticker symbol (e.g., GOOG, AAPL, TSLA)--strike - Current short strike price (optional, auto-detects from portfolio)--expiry - Current short expiration in YYYYMMDD format (optional, auto-detects)--right - Option type: C for call, P for put (default: C)--port - IB port (default: 7497 for paper trading)--account - Specific account ID (optional)--iv-multiplier - Expected-move multiplier for strike band width (default: 2.0); increase for high-IV names to surface wider roll candidatesThe script outputs JSON with mode field indicating the analysis type:
success - Booleangenerated - Timestampmode - "roll", "spread", or "new_short"symbol - Tickerunderlying_price - Current stock priceearnings_date - Next earnings date or nullexpirations_analyzed - List of expiry dates checkedcurrent_position (includes iv and delta from IB greeks), buy_to_close, roll_candidates (dict of expiry -> candidates), iv_multiplierlong_option, right, candidates_by_expirylong_position, right, candidates_by_expiry, iv_multiplierThe strike search window is IV-aware: half_band = iv_multiplier × ATM_IV × spot × √(T/365) where T is the DTE of the nearest roll expiry. For roll mode, ATM IV comes from IB model greeks on the current position's quote; if unavailable, it is estimated from the option mid-price using the Brenner-Subrahmanyam approximation. For new_short mode, a conservative default IV of 30% is used. This makes the band automatically wider for high-IV underlyings without requiring a manual override.
# Auto-detect GOOG position (short option, long option, or long stock)
uv run python scripts/roll.py GOOG --port 7497
# Specify exact short position to roll
uv run python scripts/roll.py GOOG --strike 350 --expiry 20260206 --right C
# Find short call to sell against long call (vertical spread)
uv run python scripts/roll.py AUR --right C
# Find covered put for long stock
uv run python scripts/roll.py TSLA --right P
ib-asyncyfinanceAll timestamps and time-based calculations must use the America/New_York timezone. All JSON output must include generated_at (NY time string) and data_delay fields.
Find roll options for existing short positions OR find best covered call/put to open against long stock. Use when user asks about rolling shorts, finding roll candidates, writing covered calls, or man
---name: ib-find-short-rolldescription: Find roll options for existing short positions OR find best covered call/put to open against long stock. Use…---# .claude/skills/ib-find-short-roll/SKILL.md總覽
Find roll options for existing short positions OR find best covered call/put to open against long stock. Use when user asks about rolling shorts, finding roll candidates, writing covered calls, or managing option positions. Requires TWS or IB Gateway running locally.
常見問題
從發布者下載 .claude/skills/ib-find-short-roll/SKILL.md,或複製路徑後開啟儲存庫。PlugMCP 只收錄這項技能,不代管檔案。
發布者將它存放在 https://github.com/staskh/trading_skills。
Claude、Cursor、Codex 和 Grok Build 可以讀取你從發布者儲存庫加入的 SKILL.md。在聊天中傳送技能的 GitHub 資料夾連結,Grok Bot 就會安裝它。