CtrlK
BlogDocsLog inGet started
Tessl Logo

pair-trade-screener

Statistical arbitrage tool for identifying and analyzing pair trading opportunities. Detects cointegrated stock pairs within sectors, analyzes spread behavior, calculates z-scores, and provides entry/exit recommendations for market-neutral strategies. Use when user requests pair trading opportunities, statistical arbitrage screening, mean-reversion strategies, or market-neutral portfolio construction. Supports correlation analysis, cointegration testing, and spread backtesting.

68

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 highly actionable, well-structured skill whose commands, thresholds, and script documentation are excellent. Its main weakness is verbosity: tutorial-style statistical explanations and methodology duplicated from the reference files inflate the body, and time-sensitive details are embedded without a deprecation section.

Suggestions

Move the conceptual explanations in Steps 3-5 (correlation/beta primers, 'Why Cointegration Matters', half-life derivation) into references/cointegration_guide.md and references/methodology.md, keeping only the decision thresholds inline.

Trim padded sections ('Key Advantages', 'Important Notes', and the three 'Common Use Cases' walkthroughs) and drop the version/date/pricing footer, or relocate time-sensitive details to a changelog or 'deprecated' section.

Tighten workflow steps by inlining explicit validate-then-proceed checkpoints (e.g., 'do not run cointegration tests on pairs failing the Step 2 data-quality checks') instead of deferring error handling to the Troubleshooting section.

DimensionReasoningScore

Conciseness

The operational core (threshold tables, commands, parameters, red flags) is genuinely useful, but the ~670-line body includes substantial explanation of concepts Claude already knows — 'Pair trading is a market-neutral strategy that profits from...', 'Why Cointegration Matters' bullets, Pearson/beta/z-score primers — much of which duplicates references/cointegration_guide.md and methodology.md. Time-sensitive details (Version 1.0, 'Last Updated: 2025-11-08', '$29/mo' pricing) and padded sections ('Key Advantages', 'Important Notes') add further tokens that could be trimmed.

3 / 5

Actionability

Fully executable throughout: copy-paste-ready `uv run` invocations with concrete flags for both scripts, complete parameter tables, a runnable statsmodels ADF snippet, a realistic JSON output example, and worked use cases. The common cases (sector screening, custom symbol list, single-pair analysis) are each covered with specific commands.

5 / 5

Workflow Clarity

The 8-step workflow is clearly sequenced with per-step objectives, and validation checkpoints exist (data-quality checks in Step 2, statistical minimum requirements and red flags in Quality Standards, input rejection and error behavior in Output, plus a Troubleshooting section). It falls short of the top anchor because the workflow steps themselves don't embed explicit validate-then-proceed feedback loops — error recovery is deferred to separate sections rather than inline at each checkpoint.

4 / 5

Progressive Disclosure

Bundle structure is solid: two reference files exist, are exactly one level deep, and are clearly signaled in 'Reference Documentation' with bullet summaries of their contents; both scripts are documented with purpose, usage, and parameters. The main gap is that sizeable statistical-theory content (correlation interpretation tables, cointegration explanation, half-life derivation) is inlined in the body where the reference guides already cover it — more than a minor organization gap but not the majority of the content.

4 / 5

Total

16

/

20

Passed

Description

92%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 well-crafted description that clearly states concrete capabilities and pairs them with an explicit 'Use when' clause containing natural trigger phrases. It is third-person, appropriately concise, and highly distinct within the finance/quant domain.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Detects cointegrated stock pairs within sectors, analyzes spread behavior, calculates z-scores, and provides entry/exit recommendations' — plus supported analyses ('correlation analysis, cointegration testing, and spread backtesting'), giving comprehensive coverage of the skill's capabilities. It is not merely naming a domain; each clause is a distinct, verifiable capability.

5 / 5

Completeness

It explicitly answers both questions: what it does ('Detects cointegrated stock pairs... calculates z-scores... provides entry/exit recommendations') and when to use it ('Use when user requests pair trading opportunities, statistical arbitrage screening, mean-reversion strategies, or market-neutral portfolio construction'). The 'Use when' clause contains four concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

Strong natural triggers: 'pair trading opportunities', 'statistical arbitrage screening', 'mean-reversion strategies', 'market-neutral portfolio construction' — phrases a user would plausibly say. A few common variations are missing (e.g., 'pairs trading', 'relative value', 'which stocks move together'), keeping it just short of the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

Statistical arbitrage / pair trading is a clear niche with distinct trigger vocabulary ('cointegrated', 'z-scores', 'market-neutral'), and nothing in the description is generic enough to fire for unrelated skills. Minor theoretical overlap with a general backtesting skill, but the described capability set is unmistakably this skill's.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

skill_md_line_count

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

Warning

Total

15

/

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.