CtrlK
BlogDocsLog inGet started
Tessl Logo

correlation-analysis

Correlation and cointegration analysis — co-movement discovery, deep return-correlation analysis, sector clustering, realized correlation, Engle-Granger / Johansen cointegration, half-life, Kalman dynamic hedge ratio, cross-market linkage analysis, and pair-trading signal generation

60

Quality

76%

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 ./agent/src/skills/correlation-analysis/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 dense, highly actionable body with an exemplary gated workflow and valuable domain-specific empirical data, but it is oversized for a single SKILL.md: plotting boilerplate and reference implementations belong in bundle files, and minor import/dependency gaps keep some code from being copy-paste ready.

Suggestions

Split the cointegration framework, visualization templates, and cross-market empirical tables into references/ files (e.g. references/cointegration.md, references/plots.md), keeping SKILL.md as a navigable overview.

Trim or externalize the matplotlib boilerplate (heatmap, dendrogram, signal plots) — Claude can write plotting code on demand; keep only the domain-specific annotation logic.

Make code snippets self-contained: define or stub the src.quantlib.timeseries functions, and add the missing adfuller/np imports used in monitor_spread_health and correlation_breakdown_test.

DimensionReasoningScore

Conciseness

The body is ~1100 lines with dense, mostly non-redundant analytics code and genuinely non-obvious empirical tables (regime correlation behavior, half-life ranges, cross-market lag patterns), but it also carries content Claude does not need — full matplotlib boilerplate for heatmaps, dendrograms, and signal plots, plus a long worked report example. It is not 4 because the visualization templates and several verbose docstrings could be trimmed or externalized; it is not 2 because there is little conceptual padding and the domain-specific content earns its place.

3 / 5

Actionability

Nearly all guidance is executable: complete function implementations with defaults and docstrings, concrete thresholds ('keep pairs with p < 0.05', 'half-life between 5 and 60 days'), a pip install command, and a report output template. It falls short of 5 because some snippets are not copy-paste ready — 'from src.quantlib.timeseries import ...' references a project module not in this bundle, and monitor_spread_health uses 'adfuller' and 'np' without importing them in that scope.

4 / 5

Workflow Clarity

The 'Full Workflow From Correlation to Signal' section gives five clearly sequenced steps with explicit validation criteria at each gate (Pearson > 0.6, cointegration p < 0.05, half-life 5-60 days, ADF p < 0.05), and Step 5 monitoring defines feedback loops (recompute Z-Score daily, re-test cointegration monthly, 'Warn if half-life exceeds 2× the original'), reinforced by monitor_spread_health's status-to-action mapping ('exit_now'). Mode 1's numbered scan-then-test workflow mirrors this structure.

5 / 5

Progressive Disclosure

The single SKILL.md is a monolith: the cointegration framework, plotting templates, and cross-market empirical tables are all inline with no references/, scripts/, or assets/ files at all, so content that clearly belongs in separate files is inlined. It is not 2 because internal structure is strong — clear mode sections, tables, an overview, and a notes checklist that make navigation easy despite the size.

3 / 5

Total

15

/

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, well-scoped description that comprehensively enumerates capabilities in third person, with strong distinctiveness. Its main weakness is the complete absence of a 'when to use' clause, which caps completeness, and a few missing natural synonyms ('pairs trading', 'statistical arbitrage').

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks about correlation, cointegration, pairs trading, or co-movement between assets.'

Include natural synonyms and variations users would say: 'pairs trading', 'statistical arbitrage', 'cointegration test', 'spread mean reversion'.

Keep the capability list as-is; it already covers all four analysis modes plus the cointegration framework.

DimensionReasoningScore

Specificity

The description lists many concrete, named capabilities — 'co-movement discovery, deep return-correlation analysis, sector clustering, realized correlation, Engle-Granger / Johansen cointegration, half-life, Kalman dynamic hedge ratio, cross-market linkage analysis, and pair-trading signal generation' — giving comprehensive coverage of the skill's actions in third-person voice. It is not below 4 because there are no meaningful gaps in the action list; every mode in the body is named.

5 / 5

Completeness

The 'what' is clear and detailed (the full capability list), but there is no 'Use when...' clause or equivalent trigger guidance — nothing tells the user when to invoke this skill. Per the rubric guideline, a missing 'Use when...' clause caps completeness at 3; it is not 2 because the 'what' half is explicit and comprehensive.

3 / 5

Trigger Term Quality

Good keyword coverage including natural quant terms users would say: 'correlation', 'cointegration', 'pair-trading signal generation', 'hedge ratio', 'co-movement'. It is not 5 because common variations are missing — the plain phrase 'pairs trading', 'statistical arbitrage', 'cointegration test', and file/data-agnostic synonyms are absent; it is above 3 because the included terms go beyond jargon to several phrases a practitioner would naturally use.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (quantitative correlation/cointegration analytics for pairs trading) with distinct trigger terms like 'cointegration', 'half-life', and 'Kalman dynamic hedge ratio' that no general-purpose skill would claim. Overlap risk with sibling skills is minimal.

5 / 5

Total

17

/

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 (1101 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository
HKUDS/Vibe-Trading
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.