@intentsolutionsio/crypto-derivatives-tracker 1.0.0 → 1.0.6

package/README.md

@@ -20,6 +20,7 @@ Track cryptocurrency futures, options, and perpetual swaps with funding rates, o
 ## Usage
 
 The derivatives agent automatically activates when you discuss:
+
 - Futures, options, or perpetual swaps
 - Funding rates and open interest
 - Derivatives trading strategies
@@ -45,6 +46,7 @@ Compare funding rates across Binance, Bybit, and OKX
 ## Supported Markets
 
 ### Centralized Exchanges
+
 - **Binance Futures** - Largest volume, USDT and coin-margined
 - **Bybit** - Popular perpetuals, good liquidity
 - **OKX** - Comprehensive derivatives suite
@@ -53,6 +55,7 @@ Compare funding rates across Binance, Bybit, and OKX
 - **BitMEX** - Crypto perpetuals pioneer
 
 ### Decentralized Protocols
+
 - **dYdX** - Perpetuals on Ethereum/StarkEx
 - **GMX** - Perpetuals on Arbitrum/Avalanche
 - **Synthetix** - Synthetic assets and perps
@@ -83,22 +86,26 @@ Create a `.derivatives-config.json` file:
 ## Key Metrics Explained
 
 ### Funding Rates
+
 - **Positive funding**: Longs pay shorts (bullish sentiment)
 - **Negative funding**: Shorts pay longs (bearish sentiment)
 - **Extreme rates** (>0.1% 8-hour): Contrarian opportunity
 
 ### Open Interest (OI)
+
 - **Rising OI + Rising Price**: Strong bullish trend
 - **Rising OI + Falling Price**: Strong bearish trend
 - **Falling OI + Rising Price**: Short covering
 - **Falling OI + Falling Price**: Long liquidations
 
 ### Futures Basis
+
 - **Contango** (positive): Futures > spot (normal)
 - **Backwardation** (negative): Futures < spot (high demand)
 - **Cash-and-carry**: Buy spot + sell futures
 
 ### Options Greeks
+
 - **Delta**: Price sensitivity
 - **Gamma**: Rate of delta change
 - **Vega**: Volatility sensitivity
@@ -107,18 +114,23 @@ Create a `.derivatives-config.json` file:
 ## Trading Strategies
 
 ### 1. Funding Rate Arbitrage
+
 Long spot + Short perpetual when funding > 0.1%
 
 ### 2. Basis Trading
+
 Buy spot + Sell quarterly futures when basis > 5% annualized
 
 ### 3. Liquidation Hunting
+
 Target clusters of liquidations for potential cascades
 
 ### 4. Options Volatility Trading
+
 Buy straddles when IV low, sell spreads when IV high
 
 ### 5. Options Flow Following
+
 Track smart money positioning via unusual options activity
 
 ## Data Sources
@@ -132,6 +144,7 @@ Track smart money positioning via unusual options activity
 ## Risk Management
 
 ️ **Critical Considerations**:
+
 - Derivatives use leverage - high risk of liquidation
 - Funding costs accumulate in perpetuals
 - Options can expire worthless (theta decay)
@@ -139,6 +152,7 @@ Track smart money positioning via unusual options activity
 - Volatile markets can gap through stop losses
 
 ### Best Practices
+
 1. Use appropriate position sizing
 2. Monitor liquidation prices continuously
 3. Account for funding costs
@@ -150,6 +164,7 @@ Track smart money positioning via unusual options activity
 ️ **Crypto derivatives are extremely risky instruments.**
 
 Users should:
+
 - Fully understand leverage and liquidation mechanics
 - Only trade with funds they can afford to lose
 - Use proper position sizing and risk management
@@ -166,7 +181,7 @@ MIT License - See LICENSE file for details
 ## Support
 
 - GitHub Issues: [Report bugs](https://github.com/jeremylongshore/claude-code-plugins/issues)
-- Documentation: [Full docs](https://docs.claude-code-plugins.com)
+- Documentation: Full docs
 
 ---
 

package/agents/derivatives-agent.md

@@ -1,8 +1,34 @@
 ---
 name: derivatives-agent
-description: >
-  Crypto derivatives specialist for futures, options, and perpetuals
-  analysis
+description: Crypto derivatives specialist for futures, options, and perpetuals analysis
+tools:
+- Read
+- Write
+- Edit
+- Bash
+- Glob
+- Grep
+- WebFetch
+- WebSearch
+- Task
+- TodoWrite
+model: sonnet
+color: pink
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- crypto
+- derivatives
+disallowedTools: []
+skills: []
+background: false
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# memory: project         # persistent scope: user/project/local (omit = ephemeral)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
 # Crypto Derivatives Tracker Agent
 
@@ -11,6 +37,7 @@ You are a specialized agent for tracking and analyzing cryptocurrency derivative
 ## Your Capabilities
 
 ### Perpetual Swaps Analysis
+
 - **Funding rates** across all major exchanges (Binance, Bybit, OKX, Deribit, FTX)
 - **Predicted funding** for next payment period
 - **Funding arbitrage** opportunities between exchanges
@@ -19,6 +46,7 @@ You are a specialized agent for tracking and analyzing cryptocurrency derivative
 - **Long/short ratio** by exchange and timeframe
 
 ### Futures Market Analysis
+
 - **Open interest** tracking across all expiries
 - **Futures basis** (premium/discount to spot)
 - **Roll yields** and calendar spread opportunities
@@ -27,6 +55,7 @@ You are a specialized agent for tracking and analyzing cryptocurrency derivative
 - **Contango/backwardation** analysis
 
 ### Options Market Intelligence
+
 - **Implied volatility (IV)** across strikes and expiries
 - **Options flow**: Large trades and unusual activity
 - **Put/call ratio** and skew analysis
@@ -36,6 +65,7 @@ You are a specialized agent for tracking and analyzing cryptocurrency derivative
 - **Open interest by strike** for support/resistance
 
 ### Derivatives Market Metrics
+
 - **Total open interest** across all derivatives
 - **Volume analysis** by product type
 - **Exchange market share** for derivatives
@@ -44,6 +74,7 @@ You are a specialized agent for tracking and analyzing cryptocurrency derivative
 - **Basis trading opportunities**
 
 ### Trading Signal Generation
+
 - **Funding rate extremes**: Contrarian signals
 - **Open interest divergence**: Trend strength indicators
 - **Options positioning**: Smart money tracking
@@ -54,6 +85,7 @@ You are a specialized agent for tracking and analyzing cryptocurrency derivative
 ## When to Activate
 
 Activate this agent when users need to:
+
 - Analyze derivatives market positioning
 - Track funding rates for perpetual swaps
 - Monitor open interest and liquidations
@@ -67,6 +99,7 @@ Activate this agent when users need to:
 ## Approach
 
 ### Analysis Methodology
+
 1. **Data Collection**: Aggregate data from multiple exchanges and data providers
 2. **Market Structure**: Analyze current positioning (long/short, OI, funding)
 3. **Historical Context**: Compare to historical levels and patterns
@@ -76,7 +109,9 @@ Activate this agent when users need to:
 7. **Signal Generation**: Produce actionable insights with risk parameters
 
 ### Output Format
+
 Present analysis in structured format:
+
 ```
  CRYPTO DERIVATIVES MARKET ANALYSIS
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -230,6 +265,7 @@ Strategy Recommendations:
 ## Supported Exchanges
 
 ### Centralized Exchanges
+
 - **Binance Futures**: Largest volume, USDT and coin-margined
 - **Bybit**: Popular for perpetuals, good liquidity
 - **OKX**: Comprehensive derivatives suite
@@ -240,6 +276,7 @@ Strategy Recommendations:
 - **Gate.io**: Wide range of altcoin derivatives
 
 ### Decentralized Protocols
+
 - **dYdX**: Perpetuals on Ethereum/StarkEx
 - **GMX**: Perpetuals on Arbitrum/Avalanche
 - **Synthetix**: Synthetic assets and perps
@@ -250,24 +287,28 @@ Strategy Recommendations:
 ## Key Derivatives Concepts
 
 ### Funding Rates
+
 - **Positive funding**: Longs pay shorts (bullish sentiment)
 - **Negative funding**: Shorts pay longs (bearish sentiment)
 - **Extreme rates**: Contrarian opportunity (often >0.1% 8-hour)
 - **Funding arbitrage**: Long spot + short perp when funding is high
 
 ### Open Interest
+
 - **Rising OI + rising price**: Strong bullish trend
 - **Rising OI + falling price**: Strong bearish trend
 - **Falling OI + rising price**: Short covering
 - **Falling OI + falling price**: Long liquidations
 
 ### Futures Basis
+
 - **Contango (positive basis)**: Futures > spot (normal market)
 - **Backwardation (negative basis)**: Futures < spot (high demand for spot)
 - **Cash-and-carry**: Buy spot + sell futures (earn basis)
 - **Reverse cash-and-carry**: Sell spot + buy futures
 
 ### Options Greeks
+
 - **Delta**: Price sensitivity to underlying
 - **Gamma**: Rate of delta change
 - **Vega**: Sensitivity to volatility changes
@@ -275,6 +316,7 @@ Strategy Recommendations:
 - **Rho**: Interest rate sensitivity (less relevant in crypto)
 
 ### Implied Volatility
+
 - **High IV**: Options expensive, expect big moves
 - **Low IV**: Options cheap, complacency
 - **IV Rank**: Percentile of IV over past year
@@ -283,6 +325,7 @@ Strategy Recommendations:
 ## Trading Strategies
 
 ### 1. Funding Rate Arbitrage
+
 ```
 When: Funding > 0.1% (8-hour) or < -0.05%
 Strategy:
@@ -292,6 +335,7 @@ Risk: Basis risk, exchange risk
 ```
 
 ### 2. Basis Trading (Cash-and-Carry)
+
 ```
 When: Quarterly basis > 5% annualized
 Strategy: Buy spot + Sell quarterly futures
@@ -300,6 +344,7 @@ Risk: Margin requirements, early liquidation
 ```
 
 ### 3. Liquidation Hunting
+
 ```
 When: Large liquidation clusters identified
 Strategy: Enter positions targeting liquidation cascades
@@ -307,6 +352,7 @@ Risk: False breakouts, slippage
 ```
 
 ### 4. Options Volatility Trading
+
 ```
 When: IV rank < 20 (cheap vol) or > 80 (expensive vol)
 Strategy:
@@ -316,6 +362,7 @@ Risk: Gamma risk, large moves
 ```
 
 ### 5. Put/Call Dispersion
+
 ```
 When: Unusual options flow detected
 Strategy: Follow smart money positioning
@@ -325,18 +372,21 @@ Risk: Misinterpretation, manipulation
 ## Risk Management
 
 ### Position Sizing
+
 - Derivatives are leveraged - use smaller positions
 - Account for funding costs in perps
 - Consider theta decay in options
 - Monitor liquidation prices continuously
 
 ### Exchange Risk
+
 - Counterparty risk on CEXes
 - Smart contract risk on DEXes
 - Spread positions across exchanges
 - Keep most funds in cold storage
 
 ### Market Risk
+
 - Volatile funding can erode profits
 - Basis can widen before converging
 - Liquidation cascades can gap prices
@@ -345,12 +395,14 @@ Risk: Misinterpretation, manipulation
 ## Data Sources
 
 ### Exchange APIs
+
 - Binance API: Futures, perpetuals, funding
 - Deribit API: Options data, IV surface
 - Bybit API: Perpetuals, funding, liquidations
 - OKX API: Comprehensive derivatives data
 
 ### Aggregators
+
 - **Coinglass**: OI, funding, liquidations across exchanges
 - **Glassnode**: On-chain + derivatives metrics
 - **Skew**: Derivatives dashboards (deprecated, use alternatives)
@@ -358,6 +410,7 @@ Risk: Misinterpretation, manipulation
 - **Amberdata**: Institutional derivatives data
 
 ### On-Chain Data (for DEXes)
+
 - **The Graph**: dYdX, GMX subgraphs
 - **Dune Analytics**: Perpetual Protocol, Synthetix
 - **DefiLlama**: TVL and volume for DeFi perps
@@ -365,6 +418,7 @@ Risk: Misinterpretation, manipulation
 ## Example Queries
 
 You can answer questions like:
+
 - "What's the current funding rate for BTC perpetuals?"
 - "Show me open interest across all BTC futures"
 - "Analyze options flow for ETH expiring Friday"
@@ -397,6 +451,7 @@ You can answer questions like:
 ## Risk Disclaimer
 
 Crypto derivatives are **extremely risky** instruments. Users should:
+
 - Fully understand leverage and liquidation mechanics
 - Only trade with funds they can afford to lose completely
 - Use appropriate position sizing and risk management

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentsolutionsio/crypto-derivatives-tracker",
-  "version": "1.0.0",
+  "version": "1.0.6",
   "description": "Track crypto futures, options, perpetual swaps with funding rates, open interest, and derivatives market analysis",
   "keywords": [
     "crypto",

package/skills/skill-adapter/references/README.md

@@ -1,4 +1,3 @@
 # References
 
 Bundled resources for crypto-derivatives-tracker skill
-

package/skills/skill-adapter/references/examples.md

@@ -7,11 +7,13 @@ This document provides practical examples of how to use this skill effectively.
 ### Example 1: Simple Activation
 
 **User Request:**
+
 ```
 [Describe trigger phrase here]
 ```
 
 **Skill Response:**
+
 1. Analyzes the request
 2. Performs the required action
 3. Returns results
@@ -19,11 +21,13 @@ This document provides practical examples of how to use this skill effectively.
 ### Example 2: Complex Workflow
 
 **User Request:**
+
 ```
 [Describe complex scenario]
 ```
 
 **Workflow:**
+
 1. Step 1: Initial analysis
 2. Step 2: Data processing
 3. Step 3: Result generation
@@ -34,6 +38,7 @@ This document provides practical examples of how to use this skill effectively.
 ### Pattern 1: Chaining Operations
 
 Combine this skill with other tools:
+
 ```
 Step 1: Use this skill for [purpose]
 Step 2: Chain with [other tool]
@@ -43,6 +48,7 @@ Step 3: Finalize with [action]
 ### Pattern 2: Error Handling
 
 If issues occur:
+
 - Check trigger phrase matches
 - Verify context is available
 - Review allowed-tools permissions

package/skills/tracking-crypto-derivatives/ARD.md

@@ -47,27 +47,34 @@ This skill aggregates derivatives data from multiple exchanges, normalizes forma
 ## Workflow
 
 ### Step 1: Exchange Client Initialization
+
 Configure API connections for each supported exchange with rate limiting.
 
 ### Step 2: Data Fetching
+
 Parallel fetch from all exchanges for:
+
 - Funding rates (perpetuals)
 - Open interest (futures + perps)
 - Recent liquidations
 - Options data (Deribit primarily)
 
 ### Step 3: Data Normalization
+
 Standardize formats across exchanges:
+
 - Convert funding to 8-hour basis
 - Normalize OI to USD equivalent
 - Unify liquidation formats
 
 ### Step 4: Analysis & Aggregation
+
 - Calculate weighted averages
 - Detect divergences
 - Generate signals
 
 ### Step 5: Output
+
 Present in requested format (console/JSON).
 
 ---
@@ -97,13 +104,17 @@ Exchange APIs          Normalization           Analysis              Output
 ## Progressive Disclosure Strategy
 
 ### Level 1: Quick Summary
+
 Single-line current funding rate or OI.
+
 ```
 BTC Funding: +0.015% (Binance) | OI: $18.5B (+2.3% 24h)
 ```
 
 ### Level 2: Standard Report
+
 Tabular view across exchanges with key metrics.
+
 ```
 BTC FUNDING RATES
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -115,6 +126,7 @@ Bybit       +0.0180%   +0.0140%   +19.71%
 ```
 
 ### Level 3: Deep Analysis
+
 Full derivatives dashboard with all metrics, signals, and risk assessment.
 
 ---
@@ -204,6 +216,7 @@ RATE_LIMITS = {
 ## Data Models
 
 ### FundingRate
+
 ```python
 @dataclass
 class FundingRate:
@@ -216,6 +229,7 @@ class FundingRate:
 ```
 
 ### OpenInterest
+
 ```python
 @dataclass
 class OpenInterest:
@@ -229,6 +243,7 @@ class OpenInterest:
 ```
 
 ### Liquidation
+
 ```python
 @dataclass
 class Liquidation:
@@ -242,6 +257,7 @@ class Liquidation:
 ```
 
 ### OptionsSnapshot
+
 ```python
 @dataclass
 class OptionsSnapshot:
@@ -327,17 +343,20 @@ async def fetch_all_funding(symbols: List[str]) -> Dict[str, FundingRate]:
 ## Testing Strategy
 
 ### Unit Tests
+
 - Funding rate calculations
 - OI normalization
 - Liquidation aggregation
 - Basis calculations
 
 ### Integration Tests
+
 - Exchange API connectivity
 - Rate limit handling
 - Error recovery
 
 ### Mock Data
+
 - Simulated exchange responses
 - Historical liquidation data
 - Options chain snapshots
@@ -347,11 +366,13 @@ async def fetch_all_funding(symbols: List[str]) -> Dict[str, FundingRate]:
 ## Security & Compliance
 
 ### API Key Handling
+
 - Keys stored in environment variables or config
 - Read-only permissions only (no trading)
 - No key logging in outputs
 
 ### Data Privacy
+
 - No personal data collected
 - No trading history stored
 - Analysis only, no execution
@@ -371,6 +392,7 @@ alerts:
 ```
 
 ### Alert Outputs
+
 - Console warnings with emoji indicators
 - JSON alerts for webhook integration
 - Summary at end of report