commodity-analysis

Generate directional commodity trade signals from supply-demand, inventory, term structure, and seasonality.

Updated May 5, 2026
One-click install
npx skills add https://github.com/wudye/traderAssistHK --skill commodity-analysis-wudye
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commodity-analysis
Source: https://github.com/wudye/traderAssistHK/tree/main/backend/src/skills/commodity-analysis
Command: npx skills add https://github.com/wudye/traderAssistHK --skill commodity-analysis-wudye

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you translate fragmented commodity information into a structured, backtestable directional view by combining fundamentals, inventory dynamics, term structure, and seasonality.

Core Features & Use Cases

  • Supply-Demand Directional Scoring: Interprets drivers like OPEC output compliance, US shale production, and demand proxies (imports, PMI, implied gasoline demand) to classify surplus/shortage conditions.
  • Inventory Cycle & Turning Point Framework: Maps inventory behavior (active/passive restocking and destocking) to likely price direction and actionable bias (e.g., best buying points vs warning stages).
  • Futures Premium/Discount + Seasonality Overlay: Uses contango/backwardation and spread ratios to confirm or contradict fundamentals, then adjusts with seasonal tailwinds/headwinds for commodities such as oil, gold, and copper.
  • Practical Output Template for Backtesting: Produces a consistent report format with structured sections (structure, inventory stage, term structure, composite score, direction, and confidence).

Quick Start

Use the commodity-analysis skill to generate a bullish, bearish, or neutral directional report for crude oil, gold, and copper by applying supply-demand, inventory-cycle, term-structure, and seasonality scoring rules.

Frequently Asked Questions about commodity-analysis

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

FAQPage Schema
How do I generate directional trade signals for crude oil using inventory cycle and term structure?

To generate crude oil directional trade signals, you synthesize supply-demand drivers, inventory-cycle stages, term-structure premium or discount, and seasonality into a composite score. The output provides a bullish, bearish, or neutral bias with an explicit confidence level for backtesting.

What is the best way to structure commodity analysis reports for consistent backtesting?

The best way to structure commodity analysis reports for backtesting is using a standardized template covering supply-demand scoring, inventory stage identification, term structure, and seasonality. This ensures consistent, template-based outputs across multiple economic drivers and time horizons.

How does futures term structure impact commodity pricing models for gold and copper?

Futures term structure impacts commodity pricing by using contango, backwardation, and spread ratios to confirm or contradict fundamental supply-demand drivers. For gold and copper, this premium or discount analysis adjusts the directional bias derived from inventory cycles and seasonality.

Can I use supply-demand balance scoring to identify inventory cycle turning points?

Yes, you can use supply-demand balance scoring to identify inventory cycle turning points by mapping active and passive restocking or destocking behavior. This framework classifies surplus or shortage conditions to pinpoint likely price direction and actionable buying or warning stages.

Does commodity analysis work for backtesting signals across different economic time horizons?

Commodity analysis works for backtesting signals across different economic time horizons by applying consistent scoring rules to fundamentals, inventory dynamics, term structure, and seasonality. It generates a composite score and directional bias suitable for multi-timeframe research workflows.

When should I not rely solely on supply-demand fundamentals for oil pricing analysis?

You should not rely solely on supply-demand fundamentals for oil pricing when futures term structure or seasonality contradicts the core baseline. Overlaying contango or backwardation spread ratios and seasonal tailwinds adjusts the composite score to avoid false directional bias.