ib-pmcc-advisor

Analyze PMCC (Poor Man's Covered Call / diagonal spread) positions from IB portfolio. For each diagonal spread, reports short leg risk (delta, IV, assignment probability), daily P&L projections, top-3 roll candidates, and a side-by-side comparison table. 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-pmcc-advisor/SKILL.md

Quality

Content

78%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.

A well-structured, highly actionable skill body with clear sequencing and a real error-recovery loop for the IB connection. It is held back by inlined reference material and a dangling template reference that weakens progressive disclosure.

Suggestions

Move the JSON Output Structure and Key Fields into a reference file (e.g. references/output-schema.md) and link to it from the body to reduce inline bulk.

Ensure the referenced templates/markdown-template.md actually exists in the skill bundle, or inline its formatting rules if it is not shipped.

Add brief guidance for degraded/error cases (empty spreads list, data_delay 'stalled') so the workflow has an explicit validation checkpoint on the batch result.

Dimension	Reasoning	Score
Conciseness	The body is efficient and assumes Claude's competence (no explanation of options basics), with every section tied to operating the script; only minor bits like the internal Architecture section could be trimmed.	4 / 5
Actionability	It provides a copy-paste-ready invocation, a full arguments table with defaults, three covering examples (paper default, live with options, symbol filter), and a precisely specified response format.	5 / 5
Workflow Clarity	A clear three-step sequence (run script → brief inline summary → files only on request) with a connection port-fallback feedback loop; minor gaps are the lack of guidance for empty or error script output.	4 / 5
Progressive Disclosure	Section structure is reasonable and the script reference resolves, but a large JSON Output Structure and Key Fields reference are inlined rather than split out, and the referenced templates/markdown-template.md is absent from the bundle.	3 / 5
	Total	16 / 20 Passed

Description

75%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 highly specific, concrete description that clearly communicates what the skill does and occupies a distinct niche. Its main weakness is the absence of an explicit 'when to use' trigger clause, which limits completeness.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to analyze or roll PMCC / diagonal call spread positions from their Interactive Brokers account.'

Include a few more natural user phrasings (e.g. 'covered call rolls', 'assignment risk on my diagonals') to broaden trigger coverage.

Move the 'Requires TWS or IB Gateway running locally' precondition so it reads as a usage prerequisite rather than the only 'when' signal.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — short leg risk (delta, IV, assignment probability), daily P&L projections, top-3 roll candidates, and a comparison table — giving comprehensive coverage of the skill's outputs.	5 / 5
Completeness	The 'what' is clearly and concretely stated, but there is no 'Use when…' clause or equivalent explicit trigger guidance, capping completeness at 3 per the rubric guidelines.	3 / 5
Trigger Term Quality	Domain-natural keywords and synonyms are present (PMCC, Poor Man's Covered Call, diagonal spread, roll candidates, assignment, IB portfolio), but it lacks an explicit trigger clause and a few natural user phrasings are absent.	4 / 5
Distinctiveness Conflict Risk	It targets a sharply specific niche (PMCC/diagonal spread analysis from an IB portfolio) with distinct triggers and minimal overlap risk with other skills.	5 / 5
	Total	17 / 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-pmcc-advisor/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.