Skip to content

Guide · Agent skill

How to use the Crypto Derivatives Strategies agent skill

Updated · written with AI from the project's own documentation and checked against our catalogue data

The crypto-derivatives skill is a reference playbook that teaches an AI agent how to reason about crypto derivatives: perpetual-contract funding-rate arbitrage, futures term structure (contango and backwardation), and options volatility smile and Greeks, mainly on OKX and Deribit. It suits traders, students and developers who want structured explanations and formulas. After this guide you will know how to install the skill, ask for it in natural language, and understand what it can and cannot do.

Crypto Derivatives StrategiesHKUDS/Vibe-Trading · MIT

Quick start

  1. 1Download the ZIP. Get the crypto-derivatives ZIP file from this directory page.
  2. 2Unzip into a skills folder. Place the crypto-derivatives folder containing SKILL.md in ~/.claude/skills/ or in a project's .claude/skills/ folder.
  3. 3Or upload in the Claude apps. Open Settings, go to Capabilities, then Skills, and upload the skill.
  4. 4Ask a matching question. Describe a funding-rate, basis, term-structure or options question in plain language.
  5. 5Supply your own numbers. Give the prices or rates you want analysed, since the skill does not fetch live data.
  6. 6Check the output independently. Verify figures and parameter suggestions against your exchange and your own risk limits.

What the skill makes the agent do

Agent skills are folders containing a SKILL.md file with instructions the agent reads when a request matches the skill's description. This one holds a playbook on three areas: perpetual funding-rate arbitrage, futures term-structure trading, and options strategies such as volatility smile and Greeks analysis.

Once installed, the agent can explain these concepts, interpret funding-rate levels as signals, compute basis and annualized basis from prices you supply, and walk through options structures such as short straddles, protective puts and iron butterflies with suggested parameters. The skill is static text: it does not fetch prices and does not place trades.

  • Explain perpetual funding-rate mechanics and positive or reverse carry arbitrage
  • Classify funding-rate levels into market sentiment and strategy signals
  • Compute basis and annualized basis from spot and futures prices
  • Describe contango and backwardation and the related calendar-spread ideas
  • Explain Greeks (Delta, Gamma, Theta, Vega, Rho) and the 25Δ risk reversal
  • Walk through short straddle, protective put and iron butterfly structures

Install the skill from the ZIP file

Download the ZIP file from this directory page. Unzip it so that the crypto-derivatives folder, containing SKILL.md, sits inside your skills directory. For a personal setup, use ~/.claude/skills/. For a single project, use the .claude/skills/ folder inside that project.

If you use the Claude apps instead, open Settings, go to Capabilities, and upload the skill under Skills.

  • Personal: ~/.claude/skills/crypto-derivatives/
  • Project: .claude/skills/crypto-derivatives/ inside your project
  • Claude apps: Settings → Capabilities → Skills → upload
~/.claude/skills/crypto-derivatives/SKILL.md

Trigger the skill with natural requests

You do not need a special command. Describe what you want in plain language that matches the skill's topics: funding rates, basis, term structure, volatility smile, Greeks or options structures. The agent should pick up the skill when your request fits its description.

Name the exchange or asset when it matters, since the playbook focuses on BTC and ETH on OKX and Deribit. Supply the numbers you want processed, because the skill cannot look them up.

  • "Using a funding rate of 0.02% per 8 hours, what is the annualized return?"
  • "Explain the difference between contango and backwardation in BTC futures."
  • "Walk me through a short straddle on BTC and its maximum loss profile."
  • "Compute annualized basis for the BTC quarterly future at 107000 with spot at 105000."

Use the basis and annualization formulas

The skill includes a Python function, term_structure_spread, that takes a spot price and a dictionary of futures prices by expiry, then returns the basis, annualized basis and days to expiry for each contract. It uses pandas (pd), so that library must be imported in your own code. Treat it as a starting point for a crypto analysis tool, not a finished product.

Funding is annualized in the source as funding rate × 3 × 365, because OKX settles every 8 hours.

annualized = basis / days_to_expiry * 365

Understand the risk controls and limits

The file lists the main risks of carry arbitrage: insufficient margin leading to liquidation, funding reversals, basis moves that cause floating losses, and exchange risk such as withdrawal limits and downtime. It also suggests parameters such as leverage no more than 3x and a margin ratio above 50%.

These are suggestions in the playbook, not validated performance claims. Check them against your own exchange rules and risk tolerance before relying on them.

  • Leverage: no more than 3x, per the source's suggestion
  • Margin ratio: keep above 50%
  • Single-coin allocation: under 30%
  • Stop-loss: close when floating loss exceeds expected return over 3 months

Safety notes: scripts and network

The skill runs no scripts and uses no network access, and it requires nothing to be installed beyond the file itself. Its only file is SKILL.md. The Python snippet in the text is an example for you to run in your own environment; the skill does not execute it.

Because the skill makes no network calls, it will not show current prices, funding rates or open interest. Any figure you act on needs to come from your exchange or a trusted data source.

  • No scripts are run by the skill
  • No network access is used
  • Files: SKILL.md only
  • Licence: MIT

What people use it for

  • Explaining why a positive perpetual funding rate makes long spot plus short perpetual attractive to study
  • Computing annualized basis for several BTC futures expiries from prices you enter
  • Learning how a short straddle's risk and Theta income work before paper-trading it
  • Drafting a structured explanation of contango versus backwardation for a course or report
  • Using the basis formulas as a starting point for a personal crypto analysis tool

Frequently asked questions

How do I install the crypto-derivatives agent skill?

Download the ZIP from this page and unzip the crypto-derivatives folder into ~/.claude/skills/ for personal use, or into .claude/skills/ inside a project. In the Claude apps, you can instead upload it under Settings, then Capabilities, then Skills.

Does the crypto-derivatives skill need any software or API keys?

The source lists nothing required. The skill runs no scripts and uses no network access, and its only file is SKILL.md.

Is the crypto-derivatives skill free?

The skill is released under the MIT licence, as stated on this page. Check the licence file in the source repository for the full terms.

Does the skill give live prices or place trades?

No. The skill is static text, does not fetch prices, and does not place trades on its own. You supply any numbers you want analysed.

Which exchanges does the skill cover?

The playbook mainly references OKX and Deribit, with BTC and ETH as the main underlyings. It also briefly notes Binance options liquidity.

Is this skill safe for beginners who want to trade options?

It is aimed at people who already understand margin and options. The file's own examples, such as short straddles and iron butterflies, carry significant loss potential, so beginners should learn the mechanics before using any parameter suggestion.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Use this skill if you want a structured, formula-driven explanation of crypto funding-rate and basis arbitrage, or a starting point for basis and annualization code. Pick something else if you need live market data, guaranteed returns, or a tool that places trades, since this skill is static educational guidance with significant risks.

Download the skill