commodities

Analyze commodity futures curves and decompose returns into spot, roll, and collateral components.

164|33|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/JoelLewis/finance_skills --skill commodities
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commodities
Source: https://github.com/JoelLewis/finance_skills/tree/main/plugins/wealth-management/skills/commodities
Command: npx skills add https://github.com/JoelLewis/finance_skills --skill commodities

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires numpy, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps users understand the complex dynamics of commodity markets, including futures pricing, roll yield, and the factors influencing commodity returns.

Core Features & Use Cases

  • Futures Curve Analysis: Analyze contango and backwardation to understand market expectations and potential roll yield impacts.
  • Return Decomposition: Break down commodity investment returns into spot price changes, roll yield, and collateral yield.
  • Use Case: A user asks why their commodity ETF's performance differs from the spot price of oil; this skill can explain the impact of roll yield in a contango market.

Quick Start

Analyze the futures curve for crude oil using the provided prices and days between expirations.

Frequently Asked Questions about commodities

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does my commodity ETF performance differ from the spot price of oil?

Commodity ETF performance diverges from spot prices due to roll yield. In a contango market, rolling futures contracts generates a negative roll yield, dragging total returns below spot price movements.

How do I calculate roll yield from a commodity futures curve?

Calculate roll yield by comparing futures prices across contract expirations. This skill computes roll yield by analyzing the spread between near and far month contracts, quantifying returns from rolling positions along the futures curve.

What is the difference between contango and backwardation in futures markets?

Contango occurs when futures prices exceed the spot price, creating negative roll yield. Backwardation exists when futures trade below spot, generating positive roll yield for investors holding long positions through contract rolls.

How do I decompose total commodity returns into spot, roll, and collateral components?

Decompose total commodity returns by isolating spot price changes, roll yield from contract expiration transitions, and collateral yield from cash invested. This skill calculates each component to reveal performance drivers beyond spot prices.

Can I analyze commodity futures curves using numpy?

This skill uses numpy to analyze commodity futures curves, supporting calculations for contango, backwardation, and roll yield. It processes futures prices and days between expirations to evaluate market expectations.

When should I use commodity futures analysis as an inflation hedge?

Commodity futures serve as an inflation hedge when prices rise due to supply constraints or monetary expansion. Analyzing futures curve dynamics helps identify favorable entry points and expected roll yield impacts on hedge returns.