CtrlK
BlogDocsLog inGet started
Tessl Logo

options-strategy-advisor

Options trading strategy analysis and simulation tool. Provides theoretical pricing using Black-Scholes model, Greeks calculation, strategy P/L simulation, and risk management guidance. Use when user requests options strategy analysis, covered calls, protective puts, spreads, iron condors, earnings plays, or options risk management. Includes volatility analysis, position sizing, and earnings-based strategy recommendations. Educational focus with practical trade simulation.

57

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/options-strategy-advisor/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

46%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body delivers a well-sequenced, highly actionable options-analysis workflow with concrete commands and templates, but it is roughly three times longer than needed: it re-teaches Black-Scholes and Greeks that Claude already knows and that already live in the bundled reference and script. Progressive disclosure is the weakest area — five of the eight listed bundle files do not exist while their content is partially duplicated inline.

Suggestions

Delete the inlined Black-Scholes formula derivations and per-Greek Python implementations from Steps 3-4 and point to the existing references/black_scholes_methodology.md and scripts/black_scholes.py instead — this alone would cut the body by roughly a third.

Fix the Resources section to reflect the actual bundle: remove or clearly mark the nonexistent files (strategies_guide.md, greeks_explained.md, volatility_guide.md, strategy_analyzer.py, earnings_strategy.py), or create them before advertising them.

Add explicit validation checkpoints to the workflow — e.g., after fetching FMP data verify the price is positive and within a sane range, and after pricing compare the theoretical value against any user-provided market quote before proceeding to simulation.

DimensionReasoningScore

Conciseness

The ~985-line body extensively restates textbook knowledge Claude already has — the full Black-Scholes formula derivation, per-Greek definitions and interpretation tables, and complete Python implementations of every Greek — all of which duplicate the existing 147-line references/black_scholes_methodology.md and 549-line scripts/black_scholes.py. Time-sensitive details ('~5.3% as of 2025', 'Last Updated: 2025-11-08') further penalize per the guidelines. It is not a 1 because there is genuinely skill-specific material (FMP data fetching, strategy workflows, output templates) interleaved with the padding.

2 / 5

Actionability

Mostly executable: copy-paste-ready CLI invocations ('python3 scripts/black_scholes.py --ticker AAPL --api-key $FMP_API_KEY'), runnable Python for pricing and Greeks, and a complete report template with a file-naming convention. Not a 5 because several snippets are illustrative rather than complete — calculate_pnl() references an undefined 'strategy.legs' object, 'from earnings_calendar import get_next_earnings_date' depends on another skill with no fallback, and the ASCII-diagram function references an undefined strategy_name variable.

4 / 5

Workflow Clarity

A clear 9-step sequence (gather inputs → HV → price → Greeks → simulate P/L → diagram → strategy-specific → earnings → risk management) with Objective/Method/Output per step, but validation checkpoints are absent or implicit — no step verifies API data, sanity-checks theoretical vs. market prices, or confirms inputs before simulating. The Troubleshooting section lists problem/solution pairs but is not wired into the workflow as feedback loops, matching the anchor 'steps listed but validation gaps'.

3 / 5

Progressive Disclosure

Scored against the actual bundle: only references/black_scholes_methodology.md, scripts/black_scholes.py, and scripts/tests/ exist, yet the Resources section points to three nonexistent reference files marked '(future)' (strategies_guide.md, greeks_explained.md, volatility_guide.md) and two nonexistent scripts (strategy_analyzer.py, earnings_strategy.py). Meanwhile the Black-Scholes math and all Greeks implementations are inlined in the body despite duplicating the existing reference and script — 'content that clearly belongs in separate files is inlined'. Section headers exist, which keeps this above a 1, but the phantom references actively mislead navigation.

2 / 5

Total

11

/

20

Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete capability list, explicit third-person 'Use when' triggers with named strategies, and a clear options-trading niche. The only gaps are a few missing natural synonyms (straddles, strangles, collars) that keep trigger coverage and distinctiveness just below maximum.

DimensionReasoningScore

Specificity

The description lists multiple concrete, comprehensive actions: 'theoretical pricing using Black-Scholes model, Greeks calculation, strategy P/L simulation, and risk management guidance' plus 'volatility analysis, position sizing, and earnings-based strategy recommendations'. It matches the anchor for multiple specific concrete actions with comprehensive coverage, exceeding the 'several specific actions with minor gaps' level 4 anchor.

5 / 5

Completeness

It explicitly answers both questions: what ('Provides theoretical pricing using Black-Scholes model, Greeks calculation, strategy P/L simulation, and risk management guidance') and when ('Use when user requests options strategy analysis, covered calls, protective puts, spreads, iron condors, earnings plays, or options risk management'). This matches the level 5 anchor with concrete trigger phrases; level 4 would require a less explicit 'when' clause.

5 / 5

Trigger Term Quality

Good natural-language coverage: 'options strategy analysis, covered calls, protective puts, spreads, iron condors, earnings plays, or options risk management' — phrases users would actually say. It falls short of the level 5 anchor ('comprehensive coverage of natural terms including synonyms') because common variations the skill supports are missing, e.g., straddles, strangles, collars, 'Greeks exposure', and phrasing like 'is IV high'.

4 / 5

Distinctiveness Conflict Risk

Options strategy analysis is a clear niche with distinct triggers (named strategies like iron condors and covered calls), matching 'mostly distinct; minor overlap risk'. It is not a 5 because the description omits the portfolio/technical-analysis scope boundaries, so 'earnings plays' and 'risk management' could mildly overlap with related earnings-calendar or portfolio-tracking skills referenced in the body.

4 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (991 lines); consider splitting into references/ and linking

Warning

referenced_paths_exist

Referenced path issues: 6 missing

Warning

Total

14

/

16

Passed

Repository
tradermonty/claude-trading-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.