CtrlK
BlogDocsLog inGet started
Tessl Logo

perp-funding-basis

Perpetual futures funding rate analysis and cash-carry basis trading — funding rate regimes, annualized basis signals, carry trade construction, and funding rate arbitrage between exchanges.

60

Quality

75%

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 ./a_全网优秀资源/10_大模型/07_skill包/vibe_trading_skills/perp-funding-basis/SKILL.md
SKILL.md
Quality
Evals
Security

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.

A dense, domain-rich reference with executable Python helpers, concrete thresholds, and a clear output template. Its weaknesses are the absence of an explicit analysis workflow with validation checkpoints, an API section that documents endpoints as comments rather than usable code, and a monolithic ~250-line structure with no progressive disclosure into reference files.

Suggestions

Add an explicit step-by-step analysis workflow (fetch multi-exchange funding history → classify regime → compute annualized basis → evaluate carry opportunity → render the output template) with validation checkpoints such as confirming data freshness and cross-exchange consistency.

Move the detailed signal frameworks, threshold tables, and output template into a references/ file, keeping SKILL.md as a lean overview with clearly signaled links.

Replace the commented OKX endpoint URLs with a short executable request example so the data-access section is copy-paste ready.

DimensionReasoningScore

Conciseness

The body is dense and signal-heavy — threshold tables, compact Python functions, and an output template with almost no filler. It is not a 5 because passages like 'Perpetual futures have no expiry date. Instead, a funding rate is exchanged between longs and shorts... to keep the perpetual price anchored to the spot price' and the generic 'buy spot + sell perpetual futures → collect funding rate' explanation restate knowledge Claude already has; not a 3 because the padding is minor and most tokens carry information Claude does not have (exchange schedules, thresholds, OKX endpoints).

4 / 5

Actionability

Mostly executable guidance: `funding_regime`, `annualized_basis`, `carry_trade_pnl`, and `oi_funding_matrix` are valid runnable Python, and the carry-trade execution steps name specific instruments ('Buy spot BTC-USDT on OKX spot market', 'short BTC-USDT-SWAP'). It is not a 5 because the OKX API access section shows endpoints only as comments ('# GET /api/v5/public/funding-rate-history?instId=BTC-USDT-SWAP') without a usable request example, and the historical pattern statistics ('70% probability of a 5-10% correction') are asserted without a way to verify or recompute them.

4 / 5

Workflow Clarity

The carry-trade section has a clear numbered 5-step sequence with an exit condition ('Close both legs when funding rate turns negative or basis compresses'), but the overall analysis workflow — fetch rates, classify regime, check basis, assess carry, produce the output — is never laid out as a sequence and must be inferred from the section order and output template. Validation checkpoints are implicit (e.g. no step to sanity-check data freshness or cross-exchange consistency), which matches the 'steps present but checkpoints missing or implicit' anchor rather than the 'most checkpoints present' anchor above.

3 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and the single external pointer is `load_skill("okx-market")` for data retrieval — referenced but not clearly signaled as a separate navigable resource. At ~250 lines, substantial content that could live in reference files (signal frameworks, threshold tables, output template) is inlined in SKILL.md; sections are well-organized, which lifts it above a 2, but the monolithic structure without split references fits the 'could be better organized; content that should be separate is inline' anchor.

3 / 5

Total

14

/

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 specific, well-scoped description with strong domain keywords and comprehensive capability coverage. Its main weakness is the complete absence of a 'Use when...' trigger clause, which both caps completeness and leaves invocation guidance implicit.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user mentions funding rates, perps, perpetual futures, basis, or carry trades, or asks about market positioning or leverage sentiment in crypto.'

Include common synonyms such as 'perp' and 'basis trade' to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

The description lists multiple concrete, specific capabilities — 'funding rate analysis and cash-carry basis trading', 'funding rate regimes, annualized basis signals, carry trade construction, and funding rate arbitrage between exchanges' — which map directly to the skill's body sections and comprehensively cover its scope. It is not a 4 because there are no meaningful gaps in coverage relative to what the skill does; the actions are named concretely rather than generically.

5 / 5

Completeness

The 'what' is clear and detailed (regimes, basis signals, carry construction, cross-exchange arbitrage), but there is no 'Use when...' clause or equivalent trigger guidance anywhere in the description. Per the judging guidelines, a missing 'Use when' caps completeness at 3 even with a clear 'what'.

3 / 5

Trigger Term Quality

Good natural keyword coverage: 'perpetual futures', 'funding rate', 'basis', 'cash-carry', 'arbitrage' are phrases a user analyzing perps would actually say. It is not a 5 because common synonyms like 'perp', 'funding rates', or 'basis trade' are missing; it is not a 3 because coverage clearly goes beyond a couple of generic terms and hits the domain's real vocabulary.

4 / 5

Distinctiveness Conflict Risk

This is a clear niche — perpetual funding rates and cash-carry basis trading — with distinct trigger terms (funding rate, basis, carry, perp) that would not plausibly fire for unrelated skills. It is not a 4 because the vocabulary is domain-unique enough that even closely related crypto skills would not be confused with it.

5 / 5

Total

17

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
charliedream1/ai_quant_trade
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.