options-execution
SkillDev toolsOptions trade execution, directional strategies long call covered call collar, spread strategies bull call bear put ratio ladder, volatility strategies straddle strangle strap strip, liquidity cost and implied volatility filters, integration with gold.technical_setups for options setup matching
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the options-execution skill
What this skill tells your AI
The instructions your AI receives, as published by agentii-ai/agentii-investment-intelligence in plugins/vertical-plugins/technical-analysis/skills/agentii/options-execution/SKILL.md and read by ahel’s review.
Methodology fused from professional options trading frameworks; all text is an original paraphrase.
Defaults
| Parameter | Default Value | Rationale |
|---|---|---|
| min_days_to_expiry | 45 | Buying strategies need time for thesis to develop |
| max_days_to_expiry_sell | 45 | Selling strategies capture theta decay in 30-45 day window |
| exit_dte_threshold | 21 | Exit or roll buying strategies before 21 DTE to avoid gamma risk |
| bid_ask_max_spread | 5% | Illiquid options destroy edge through wide spreads |
| max_position_risk | 2% | Maximum capital risk per single options trade |
Preflight
Run canonical pre-flight per contracts/preflight.md. Propagate X-Agentii-Trace per contracts/x-agentii-trace-header.md.
Data Source Priority
- Options execution framework —
references/options-strategies.md(bundled strategy reference) - Upstream context — market structure from
price-action+ pattern identification fromchart-patterns - Options setups —
search_technical_setups(instrument_scope=["option"], ...)for matching againstgold.technical_setups
Methodology
Retrieval Scope
structured_only
Retrieval Strategy
This skill follows Branch (d) Simple Lookup from contracts/retrieval.md: the strategy framework is bundled in references/options-strategies.md. Real-time data via get_realtime_quote. Matched options setups via search_technical_setups(instrument_scope=["option"]). No unstructured document retrieval.
Temporal Scope
See frontmatter temporal_scope block.
Tool Allowlist
See frontmatter allowed_tools.
Protocol
This skill implements a professional options execution framework. Options are treated as execution tools for expressing directional or volatility views with defined risk — not as standalone gambling instruments. The framework applies three mandatory filters (liquidity, cost, volatility) before any strategy selection. Detailed strategy definitions, the strategy→market condition matrix, and execution rules are in references/options-strategies.md.
Step 1 — Macro and Volatility Context
- Assess broad market volatility via VIX or equivalent from
get_realtime_quote. - Classify IV environment: High IV (> 70th percentile) → favor premium-selling strategies. Low IV (< 30th percentile) → favor premium-buying strategies. Mid-range → balanced.
- Macro regime from upstream analysis: expansion favors longs, contraction favors shorts; high uncertainty favors straddle/strangle.
Step 2 — Directional Thesis Input
- Receive Always In direction from
price-actionskill. - Receive primary pattern and confidence level from
chart-patternsskill. - If no upstream context: derive from raw price data and fundamental thesis.
- Classify thesis: Bullish / Bearish / Neutral / Direction-uncertain-large-move-expected.
Step 3 — Strategy Selection
Apply the strategy matrix to select the appropriate options structure:
- Apply filters: Check liquidity (bid-ask spread), cost (premium vs position), IV environment.
- Map thesis to strategy: Use the strategy→condition matrix in
references/options-strategies.md. - Query pipeline setups:
search_technical_setups(instrument_scope=["option"], pattern_type=<derived>)for matching strategy setups fromgold.technical_setups. - Load full setup:
get_technical_setup(setup_id=<best_match>)for exact parameters. - Fallback: Use manual strategy rules from the reference.
Step 4 — Execution Plan
- Strike selection: OTM for directional (delta 0.40-0.60), ATM for straddles, OTM for strangles.
- Expiry selection: 45-60 DTE for buying strategies, 30-45 DTE for selling strategies.
- Position sizing: Risk/contract ≤ 2% of capital. For selling strategies, size on notional exposure.
- Exit plan: Profit target, time stop (21 DTE for buys), stop loss level.
- Invalidation: Conditions that void the trade (thesis break, IV regime change, liquidity deterioration).
Step 5 — Trade Plan Output
- Strategy: Selected options strategy with justification from the matrix.
- Contract Specs: Strike(s), expiry, type (call/put), net debit/credit.
- Risk: Maximum loss in dollars and percentage of capital.
- Reward: Target profit, probability of profit (if calculable).
- Breakeven: Exact breakeven price(s) at expiration.
- Management Plan: Roll/adjust/exit conditions.
- Setup Match: If from
gold.technical_setups, include setup_id and research_score.
Output File
{ticker}/{YYYY-MM-DD_HHMM}_options-execution_{affix}.md
Output Structure
- Executive Summary — Selected strategy, market conditions, thesis alignment, key contract specs
- Volatility Context — IV percentile, IV environment classification, implications for strategy selection
- Directional Thesis — Price-action derived view, pattern context, confidence level
- Filter Results — Liquidity check (bid-ask), cost assessment, IV filter outcome
- Strategy Selection — Strategy matrix match, pipeline setup match (if any), justification
- Contract Specifications — Exact strikes, expiry, premiums, net debit/credit
- Risk and Reward — Max loss, max profit, breakeven(s), probability assessment
- Management Plan — Entry timing, profit targets, time stop, adjustment triggers
- Coverage Gaps — Data limitations, manual vs pipeline-derived parameters
Error Handling
| Error | Fallback |
|---|---|
| No matching options setup from MCP | Use manual strategy rules from references/options-strategies.md; flag coverage_gap |
| IV data unavailable | Assume mid-range IV; flag as degraded |
| Bid-ask wider than 5% | Flag as low-liquidity; suggest alternative strikes or skip |
| No directional thesis from upstream | Derive from raw price data; flag as independently determined |
search_technical_setups unreachable | Use full manual strategy matrix; flag all parameters |
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 referencing matched gold.technical_setups entries.
References
references/options-strategies.mdcontracts/citation-and-memory.mdcontracts/output-frontmatter-schema.mdcontracts/memory-load.mdcontracts/snapshot-synthesis.mdcontracts/preflight.mdcontracts/retrieval.md
Signals
- GitHub stars
- 204
- Forks
- 16
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
options-execution- Source
- github.com/agentii-ai/agentii-investment-intelligence