ib-find-short-roll

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.

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/ib-find-short-roll/SKILL.md

Quality

Content

65%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 is actionable and mostly concise with a real executable script and good examples, but the workflow lacks an explicit validation checkpoint and references two paths (templates/markdown-template.md, sandbox/) that are absent from the bundle.

Suggestions

Add an explicit validation checkpoint between Step 1 and Step 2, e.g. 'Check the JSON success field; if false, surface the error to the user before formatting.'

Either include templates/markdown-template.md in the bundle or inline the formatting instructions in SKILL.md so Step 2 is not a dead-end reference.

Clarify that sandbox/ should be created if absent, or move report output to a path the skill guarantees exists.

Dimension	Reasoning	Score
Conciseness	Largely efficient with executable commands, args, and copy-paste examples; minor redundancy from restating flags in both the usage line and the Arguments section, and the dense strike-band formula is justified domain detail Claude lacks.	4 / 5
Actionability	Provides a concrete, runnable command with real ticker examples and documents JSON output fields, but Step 2 references a 'templates/markdown-template.md' file that is not present in the bundle.	4 / 5
Workflow Clarity	Three steps are sequenced (Gather, Format, Report) and port-fallback retry is a feedback loop, but there is no explicit checkpoint to verify the script's 'success' field or data validity before formatting the report.	3 / 5
Progressive Disclosure	Sections are well organized and scripts/roll.py is a valid one-level-deep reference, but Step 2 points to a missing 'templates/markdown-template.md' and a missing 'sandbox/' directory, creating navigation dead-ends.	3 / 5
	Total	14 / 20 Passed

Description

87%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, well-targeted description that concretely states both capability and trigger conditions with a clear broker dependency. Only minor gaps in action breadth and synonym coverage keep specificity and trigger quality at 4.

Dimension	Reasoning	Score
Specificity	Names the domain and several concrete actions ('Find roll options for existing short positions', 'find best covered call/put to open against long stock'), but the action list is only ~2-3 items rather than a comprehensive multi-action enumeration.	4 / 5
Completeness	Explicitly states what the skill does and provides a concrete 'Use when user asks about...' trigger clause, matching the anchor for a complete what-and-when description.	5 / 5
Trigger Term Quality	Includes natural phrases a trader would say ('rolling shorts', 'finding roll candidates', 'writing covered calls', 'managing option positions'); a few natural synonyms like 'protective put' or 'covered put' are absent.	4 / 5
Distinctiveness Conflict Risk	The narrow options-strategy niche plus 'Requires TWS or IB Gateway running locally' gives it a clear, distinct trigger surface with minimal overlap with other skills.	5 / 5
	Total	18 / 20 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: staskh/trading_skills
Path: .claude/skills/ib-find-short-roll/SKILL.md
Commit: 9a1bf57

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

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.