{"id":"c94ee680-5bba-4633-a62e-5b4f76b821b0","entityType":"agent","slug":"clawhub-finskills-commodity-macro-signal","name":"commodity-macro-signal","canonicalUrl":"https://www.xpersona.co/agent/clawhub-finskills-commodity-macro-signal","canonicalPath":"/agent/clawhub-finskills-commodity-macro-signal","generatedAt":"2026-10-13T09:32:02.236Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-12T00:53:42.229Z","emptyReason":null},"description":"Analyze energy, metals, and agricultural commodity markets alongside macro indicators to generate cross-asset macro signals. Skill: commodity-macro-signal Owner: finskills Summary: Analyze energy, metals, and agricultural commodity markets alongside macro indicators to generate cross-asset macro signals. Tags: latest:1.0.1 Version history: v1.0.1 | 2026-04-18T15:47:52.044Z | user - Added a skill manifest block (metadata) including API key requirements, author, and homepage info. - Updated API key setup instructions for clarity and direct r","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 965 downloads reported by the source. Last updated 10/12/2026.","installCommand":"clawhub skill install s179tgs48y0pmgcemse7r2m5w18476rn:commodity-macro-signal","sourceUrl":"https://clawhub.ai/finskills/commodity-macro-signal","homepage":"https://clawhub.ai/finskills/skills/commodity-macro-signal","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/finskills/commodity-macro-signal","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/finskills/skills/commodity-macro-signal","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Analyze energy, metals, and agricultural commodity markets alongside macro indicators to generate cross-asset macro signals. Skill: commodity-macro-signal Owner"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-12T00:53:42.229Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-12T00:53:42.229Z","emptyReason":null},"stars":null,"forks":null,"downloads":965,"likes":null,"task":null,"library":null,"packageName":null,"latestVersion":"1.0.1","tractionLabel":"965 downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-12T00:53:42.217Z","emptyReason":null},"lastUpdatedAt":"2026-10-12T00:53:42.229Z","lastCrawledAt":"2026-10-12T00:53:42.217Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-13T00:53:42.217Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.1","createdAt":"2026-04-18T15:47:52.044Z","changelog":"- Added a skill manifest block (metadata) including API key requirements, author, and homepage info. - Updated API key setup instructions for clarity and direct registration link. - No changes to code functionality or API usage; documentation update only.","fileCount":4,"zipByteSize":7651},{"version":"1.0.0","createdAt":"2026-04-18T13:05:07.207Z","changelog":"Commodity Macro Signal — Initial Release - Provides macro analysis of global commodity markets using free-tier Finskills API data. - Covers key commodities: energy (oil, gas), precious and industrial metals, agriculture, and major commodity indices. - Synthesizes trend and direction signals (1M/3M/YTD) for inflation and economic growth assessment. - Maps commodity movements to macro signals (e.g., oil/gold/copper trend implications) and asset class impacts. - Offers sector-level impact analysis with actionable insights for equities, bonds, and alternative assets. - Requires a Finskills API key (free tier supported) for all data retrieval.","fileCount":3,"zipByteSize":6305}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s179tgs48y0pmgcemse7r2m5w18476rn:commodity-macro-signal","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-finskills-commodity-macro-signal/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-finskills-commodity-macro-signal/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-finskills-commodity-macro-signal/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-finskills-commodity-macro-signal/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-finskills-commodity-macro-signal/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-finskills-commodity-macro-signal/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-13T09:32:02.236Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-finskills-commodity-macro-signal/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-finskills-commodity-macro-signal/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-finskills-commodity-macro-signal/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-finskills-commodity-macro-signal/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-12T00:53:42.229Z","emptyReason":null},"readme":"Skill: commodity-macro-signal\n\nOwner: finskills\n\nSummary: Analyze energy, metals, and agricultural commodity markets alongside macro indicators to generate cross-asset macro signals.\n\nTags: latest:1.0.1\n\nVersion history:\n\nv1.0.1 | 2026-04-18T15:47:52.044Z | user\n\n- Added a skill manifest block (metadata) including API key requirements, author, and homepage info.\n- Updated API key setup instructions for clarity and direct registration link.\n- No changes to code functionality or API usage; documentation update only.\n\nv1.0.0 | 2026-04-18T13:05:07.207Z | user\n\nCommodity Macro Signal — Initial Release\n\n- Provides macro analysis of global commodity markets using free-tier Finskills API data.\n- Covers key commodities: energy (oil, gas), precious and industrial metals, agriculture, and major commodity indices.\n- Synthesizes trend and direction signals (1M/3M/YTD) for inflation and economic growth assessment.\n- Maps commodity movements to macro signals (e.g., oil/gold/copper trend implications) and asset class impacts.\n- Offers sector-level impact analysis with actionable insights for equities, bonds, and alternative assets.\n- Requires a Finskills API key (free tier supported) for all data retrieval.\n\nArchive index:\n\nArchive v1.0.1: 4 files, 7651 bytes\n\nFiles: README.md (2916b), skill-card.md (2033b), SKILL.md (11059b), _meta.json (141b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: Commodity Macro Signal\nversion: 1.0.2\ndescription: \"Analyze energy, metals, and agricultural commodity markets alongside macro indicators to generate cross-asset macro signals.\"\nauthor: finskills\nmetadata:\n  openclaw:\n    requires:\n      env:\n        - FINSKILLS_API_KEY\n    primaryEnv: FINSKILLS_API_KEY\n  homepage: https://github.com/finskills/commodity-macro-signal\n---\n\n# Commodity Macro Signal\n\nAnalyze global commodity markets to extract macro signals for inflation, growth,\nand supply chain dynamics using free-tier Finskills API data. Covers energy\n(crude oil, natural gas), precious metals (gold, silver), industrial metals\n(copper), agricultural products, and FRED/IMF commodity indices — then synthesizes\ninvestment implications across asset classes.\n\n---\n\n## Setup\n\n**API Key required** — [Register at https://finskills.net](https://finskills.net) to get your free key.  \nHeader: `X-API-Key: <your_api_key>`\n> **Get your API key**: Register at **https://finskills.net** — free tier available, Pro plan unlocks real-time quotes, history, and financials.\n\n---\n\n## When to Activate This Skill\n\nActivate when the user:\n- Asks about oil, gold, copper, natural gas, silver, or agricultural commodity prices\n- Wants to understand what rising/falling commodity prices mean for markets\n- Asks \"is this inflationary or deflationary?\"\n- Wants a commodity-driven macro analysis\n- Asks about Dr. Copper, gold/silver ratio, oil equity ratio\n- Wants to know how commodities affect specific sectors (energy, materials, airlines, etc.)\n\n---\n\n## Data Retrieval — Finskills API Calls\n\n### 1. All Commodity Spot Prices (Snapshot)\n```\nGET https://finskills.net/v1/free/commodity/prices\n```\nExtract the full commodity price dashboard:\n- Energy: `crude_oil_wti`, `crude_oil_brent`, `natural_gas`, `heating_oil`, `gasoline`\n- Metals: `gold`, `silver`, `platinum`, `copper`, `aluminum`, `iron_ore`\n- Agricultural: `corn`, `wheat`, `soybeans`, `coffee`, `cotton`, `sugar`\n\n### 2. Individual Commodity History (for trend analysis)\nFor key commodities, fetch 1-year daily history:\n```\nGET https://finskills.net/v1/free/commodity/history/{symbol}\n```\nTarget symbols: `WTI` (crude oil), `gold`, `copper`, `natgas`, `wheat`  \nExtract: date, price, change\n\n### 3. FRED Commodity Data Series\n```\nGET https://finskills.net/v1/free/commodity/fred\n```\nLists all available FRED commodity series.\n\n```\nGET https://finskills.net/v1/free/commodity/fred/{seriesId}\n```\nKey series to pull:\n- `DCOILWTICO`: WTI Crude Oil Daily Price\n- `GOLDAMGBD228NLBM`: Gold Price Daily\n- `PCOPPUSDM`: Copper Price Monthly\n- `TERMCBPER24NS`: Not applicable — use commodity endpoint instead\n\n### 4. IMF Commodity Index\n```\nGET https://finskills.net/v1/free/commodity/imf\n```\nExtract: IMF primary commodity price index (energy, metals, food sub-indices)  \nUse for: broad commodity cycle positioning (secular bull/bear)\n\n---\n\n## Analysis Workflow\n\n### Step 1 — Commodity Price Dashboard\n\nCreate a snapshot of all key commodities with direction signals:\n\nFor each commodity, classify:\n- **Near-term trend** (1-month): using price change % from history\n- **Medium-term trend** (3-month): using price change % from history\n- **Annual trend** (1-year): YTD change\n\n```\nDirection = {RALLYING ↑ / FALLING ↓ / FLAT ~} based on 1M change\n```\n\n### Step 2 — Key Macro Signal Derivation\n\n**Oil Price Signal (Economic Activity + Inflation):**\n- WTI > $90/bbl: Demand or supply-driven? Check supply context\n  - Demand-driven high prices (global growth): Bullish for equities (especially energy, materials)\n  - Supply-constriction high prices (OPEC cut): Stagflationary (bad for most assets)\n- WTI $60–$90: Normal regime, not a major headwind\n- WTI < $60: Disinflation signal; positive for airlines, transport, consumer discretionary\n\n**Gold Signal (Safe Haven + Real Rate Indicator):**\nGold is inversely correlated with real interest rates (nominal rate - inflation expectations):\n- Gold rising while rates rising: Unusual strength → fear of financial crisis or dollar weakness\n- Gold rising while rates stable/falling: Real rates falling → inflationary signal\n- Gold falling while rates rising: Normal correlation → risk-on, growth regime\n\n**Gold/Silver Ratio:**\n```\nGold_Silver_Ratio = gold_price / silver_price\n```\n- Ratio > 80: Economic uncertainty, risk-off (gold outperforms industrial silver)\n- Ratio < 60: Industrial demand strong, economic expansion (silver outperforms)\n\n**Copper Signal (\"Dr. Copper\" — Economic Barometer):**\n- Copper rising: Global manufacturing expansion, China construction activity strong\n- Copper falling: Global slowdown signal, watch emerging markets\n- Copper/Gold Ratio: Rising ratio → economic growth; Falling → risk-off\n\n```\nCopper_Gold_Ratio = copper_price (in cents/lb) / gold_price (in $/oz)\n```\nWhen ratio rises: Yields typically follow — confirms growth regime\nWhen ratio falls: Deflationary forces at work\n\n**Natural Gas Signal (Seasonal + Domestic):**\n- Winter: High nat gas = positive for utilities, LNG exporters, coal substitution\n- Summer: High nat gas = heat wave demand; positive for utilities\n\n**Agricultural Commodities Signal (Food Inflation):**\n- Wheat > $7/bushel: Food inflation pressure, CPI food component rising\n- Corn, Soy: Input cost for livestock, ethanol, food processing\n\n### Step 3 — Commodity Cycle Classification\n\nClassify the current phase of the commodity super-cycle:\n\n| Phase | Characteristics | Signal |\n|-------|----------------|--------|\n| **Early Bull** | Energy/metals rising from cyclical lows; USD weakening | Buy commodities, energy stocks, miners |\n| **Middle Bull** | Broad commodity rally; tight supply; high margins | Overweight materials, energy; watch inflation |\n| **Late Bull** | Speculative excess; soft commodities surging | Central bank tightening; equities under pressure |\n| **Early Bear** | Commodities peak; demand destruction; rate hike impact | Short energy, reduce materials |\n| **Middle Bear** | Broad selloff; energy struggling; metals weak | Defensive positioning |\n| **Late Bear** | Commodity lows; capex cuts building future supply deficit | Accumulate energy/materials for next cycle |\n\nAssign to current phase based on: direction of multiple commodity prices + interest rate environment.\n\n### Step 4 — Asset Class Implications Matrix\n\nBased on commodity signals, generate implications for asset classes:\n\n| Commodity Signal | Asset Class Implication |\n|----------------|------------------------|\n| Oil ↑ (demand) | Energy stocks ↑; Airlines ↓; Discretionary ↓; Oil-exporting EM ↑ |\n| Oil ↑ (supply cut) | All equities ↓; Gold ↑; TIPS ↑; Consumer sentiment ↓ |\n| Oil ↓ | Airlines ↑; Consumer discretionary ↑; Energy stocks ↓; EM exporters ↓ |\n| Gold ↑, Rates ↓ | Risk-off; Bonds ↑; USD ↓; Miners ↑ |\n| Gold ↓, Rates ↑ | Risk-on; Equities ↑; Value > Growth |\n| Copper ↑ | Industrials ↑; Emerging markets ↑; Materials ↑ |\n| Copper ↓ | Global slowdown; Defensive sectors ↑ |\n| Broad Agri ↑ | CPI food component ↑; Consumer staples mixed; EM stress |\n| Broad Commodity Rally | TIPS ↑; Energy ↑; Materials ↑; Value ↑ over Growth |\n| Broad Commodity Decline | Equities mixed; Discretionary ↑; Disinflation tailwind |\n\n### Step 5 — Sector-Level Impact\n\nMap to specific equity sectors:\n- **Energy (XLE)**: Directly correlated with WTI crude\n- **Materials (XLB)**: Copper, aluminum, iron ore, potash\n- **Industrials (XLI)**: Broad commodity demand signal\n- **Consumer Staples (XLP)**: Wheat, corn, sugar as input costs\n- **Consumer Discretionary (XLY)**: Gasoline price as consumer purchasing power headwind\n- **Utilities (XLU)**: Natural gas as fuel input cost\n- **Airlines**: Jet fuel (kerosene, highly correlated to crude) as major cost\n- **Miners/Gold stocks (GDX)**: Gold and silver price leverage\n\n---\n\n## Output Format\n\n```\n╔══════════════════════════════════════════════════════════════╗\n║    COMMODITY MACRO SIGNAL REPORT  —  {DATE}                 ║\n╚══════════════════════════════════════════════════════════════╝\n\n🛢️  ENERGY\n  WTI Crude Oil:   ${price}/bbl   {+/-}%  1M  {+/-}%  3M  {+/-}%  YTD\n  Brent Crude:     ${price}/bbl   {+/-}%  1M\n  Natural Gas:     ${price}/MMBtu {+/-}%  1M\n  Gasoline:        ${price}/gal   {+/-}%  1M\n  Oil Signal:  →  {DEMAND-DRIVEN SURGE / SUPPLY CUT SURGE / NORMAL RANGE / DEFLATIONARY DROP}\n\n🥇 PRECIOUS METALS\n  Gold:     ${price}/oz    {+/-}%  1M  {+/-}%  3M  {+/-}%  YTD\n  Silver:   ${price}/oz    {+/-}%  1M\n  Platinum: ${price}/oz    {+/-}%  1M\n  Gold/Silver Ratio: {ratio:.1f}  →  {RISK-OFF / NORMAL / RISK-ON}\n  Gold Signal: →  {SAFE HAVEN DEMAND / REAL RATES FALLING / NORMAL}\n\n⚙️  INDUSTRIAL METALS (\"Dr. Copper\")\n  Copper:   ${price}¢/lb   {+/-}%  1M  {+/-}%  3M\n  Aluminum: ${price}/ton   {+/-}%  1M\n  Iron Ore: ${price}/ton   {+/-}%  1M\n  Copper/Gold Ratio: {ratio:.4f}  →  {Growth signal rising / Declining = risk-off}\n  Industrial Signal: →  {EXPANSION / SLOWING / CONTRACTION}\n\n🌾 AGRICULTURAL\n  Corn:    ${price}/bu     {+/-}%  1M\n  Wheat:   ${price}/bu     {+/-}%  1M\n  Soybeans:${price}/bu     {+/-}%  1M\n  Coffee:  ${price}¢/lb    {+/-}%  1M\n  Agri Signal: →  {FOOD INFLATION PRESSURE / STABLE / DEFLATIONARY}\n\n📊 IMF COMMODITY INDICES\n  IMF All Commodities:  {index}  {+/-}%  3M\n  IMF Energy Sub-Index: {index}  {+/-}%  3M\n  IMF Metals Index:     {index}  {+/-}%  3M\n  IMF Food Index:       {index}  {+/-}%  3M\n  Cycle Phase: →  {EARLY BULL / MIDDLE BULL / LATE BULL / EARLY BEAR / LATE BEAR}\n\n💡 MACRO SYNTHESIS\n  Inflationary pressure:   {HIGH / MODERATE / LOW}\n  Growth signal:           {EXPANSION / MIXED / CONTRACTION}\n  USD implication:         {BEARISH on USD / NEUTRAL / BULLISH on USD}\n\n📈 ASSET CLASS IMPLICATIONS\n  OVERWEIGHT:   {asset classes and sectors benefiting from current commodity signals}\n  UNDERWEIGHT:  {asset classes hurt by current commodity signals}\n\n  Sector Playbook:\n    Energy (XLE):       {↑ Strong tailwind / → Neutral / ↓ Headwind}\n    Materials (XLB):    {↑ / → / ↓}\n    Industrials (XLI):  {↑ / → / ↓}\n    Airlines:           {↑ / → / ↓}\n    Consumer:           {↑ / → / ↓}\n    Gold Miners (GDX):  {↑ / → / ↓}\n\n🔍 KEY SIGNAL TO WATCH\n  {The one commodity ratio or indicator that best captures current macro regime transition,\n   and what a move above/below X level would imply for portfolio positioning.}\n```\n\n---\n\n## Limitations\n\n- Commodity spot prices may lag physical markets by 1 business day.\n- Supply-driven vs. demand-driven price changes require judgment — always consider news context.\n- Agricultural commodity prices are highly seasonal and weather-dependent.\n- The copper/gold ratio as a growth signal works best over multi-month periods, not day-to-day.\n\nFile v1.0.1:README.md\n\n# commodity-macro-signal\n\n> Analyze energy, metals, and agricultural commodity prices to extract macro signals for inflation, growth, and sector rotation — all via free-tier [Finskills API](https://finskills.net) commodity endpoints.\n\n[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)]()\n[![Plan](https://img.shields.io/badge/API%20Plan-Free-brightgreen.svg)](https://finskills.net/register)\n[![Category](https://img.shields.io/badge/category-macro-commodities-brown.svg)]()\n\n---\n\n## What This Skill Does\n\n1. Fetches a full commodity price dashboard: energy (WTI/Brent, NatGas), metals (Gold, Silver, Copper), agricultural (Wheat, Corn, Soybeans)\n2. Computes 1M/3M/YTD trends per commodity\n3. Calculates macro signal ratios: Gold/Silver ratio, Copper/Gold ratio (\"Dr. Copper\")\n4. Fetches FRED and IMF commodity indices for broader cycle context\n5. Classifies current commodity super-cycle phase (Early Bull → Late Bear)\n6. Maps commodity signals to sector and asset class implications (OW/N/UW)\n\n**All API endpoints used are on the free tier — no Pro plan required.**\n\n## Install\n\nAdd this skill via [ClawHub](https://clawhub.ai/finskills/commodity-macro-signal):\n\n1. Visit **[https://clawhub.ai/finskills/commodity-macro-signal](https://clawhub.ai/finskills/commodity-macro-signal)**\n2. Click **Download zip** and follow the setup instructions\n3. Set your API key: `FINSKILLS_API_KEY=your_key_here`\n\n## Quick Start\n\n```\nYou: What are commodity prices telling us about the macro environment?\nClaude: [Fetches all commodity prices + history + FRED series, computes ratios, outputs macro signal report]\n```\n\n## Example Triggers\n\n- `\"What's the signal from oil prices right now?\"`\n- `\"Is gold rising for good or bad reasons?\"`\n- `\"What is Dr. Copper saying about the economy?\"`\n- `\"Give me a commodities macro panel\"`\n- `\"Should I overweight energy or materials based on commodities?\"`\n\n## Key Signal Ratios\n\n| Ratio | Interpretation |\n|-------|---------------|\n| Gold/Silver > 80 | Risk-off, economic uncertainty |\n| Gold/Silver < 60 | Risk-on, industrial expansion |\n| Copper/Gold rising | Growth regime, yields following |\n| Copper/Gold falling | Deflationary / slowdown signal |\n| WTI > $90 | High inflation pressure or supply shock |\n| WTI < $60 | Disinflation, consumer spending tailwind |\n\n## API Endpoints Used (All Free)\n\n| Endpoint | Data |\n|----------|------|\n| `GET /v1/free/commodity/prices` | All commodity spot prices |\n| `GET /v1/free/commodity/history/{symbol}` | 1Y history for WTI, Gold, Copper |\n| `GET /v1/free/commodity/fred/{seriesId}` | FRED commodity series (DCOILWTICO, etc.) |\n| `GET /v1/free/commodity/imf` | IMF all-commodity + sub-indices |\n\n## Requirements\n\n- **Finskills API Key**: [Register at finskills.net](https://finskills.net) (free tier available) — **free plan is sufficient**\n- **Claude** with skill support\n\n## License\n\nMIT — see [LICENSE](../LICENSE)\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn7ebwb8j890wdqw56b58x77w182snyh\",\n  \"slug\": \"commodity-macro-signal\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1776527272044\n}\n\nFile v1.0.1:skill-card.md\n\n## Description:\n\nAnalyze energy, metals, and agricultural commodity markets alongside macro indicators to generate cross-asset macro signals.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[finskills](https://clawhub.ai/user/finskills)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers, analysts, and financial research teams use this skill to fetch Finskills commodity data and produce macro signal reports about inflation, growth, sector rotation, and asset-class implications.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Commodity macro interpretations may be mistaken for personalized trading advice.\n\nMitigation: Frame results as informational market analysis and avoid automated trading or individualized portfolio recommendations.\n\nRisk: The skill requires a Finskills API key for commodity data requests.\n\nMitigation: Keep FINSKILLS_API_KEY in environment configuration and avoid exposing it in prompts, logs, or generated reports.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/finskills/skills/commodity-macro-signal)\n- [Project homepage](https://github.com/finskills/commodity-macro-signal)\n- [Finskills API registration](https://finskills.net)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, API calls, Guidance]\n\n**Output Format:** [Markdown market analysis report with commodity snapshots, signal ratios, cycle classification, and sector implications.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires FINSKILLS_API_KEY; outputs should be treated as informational market analysis, not automated trading or personalized financial advice.]\n\n## Skill Version(s):\n\n1.0.1 (source: server release metadata; target metadata agrees)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.0: 3 files, 6305 bytes\n\nFiles: README.md (2741b), SKILL.md (10644b), _meta.json (141b)\n\nFile v1.0.0:SKILL.md\n\n# Commodity Macro Signal\n\nAnalyze global commodity markets to extract macro signals for inflation, growth,\nand supply chain dynamics using free-tier Finskills API data. Covers energy\n(crude oil, natural gas), precious metals (gold, silver), industrial metals\n(copper), agricultural products, and FRED/IMF commodity indices — then synthesizes\ninvestment implications across asset classes.\n\n---\n\n## Setup\n\n**API Key required** — All endpoints in this skill are on the free tier.  \nHeader: `X-API-Key: <your_api_key>`\n> **Get your API key**: Register at **https://finskills.net** — free tier available, Pro plan unlocks real-time quotes, history, and financials.\n\n---\n\n## When to Activate This Skill\n\nActivate when the user:\n- Asks about oil, gold, copper, natural gas, silver, or agricultural commodity prices\n- Wants to understand what rising/falling commodity prices mean for markets\n- Asks \"is this inflationary or deflationary?\"\n- Wants a commodity-driven macro analysis\n- Asks about Dr. Copper, gold/silver ratio, oil equity ratio\n- Wants to know how commodities affect specific sectors (energy, materials, airlines, etc.)\n\n---\n\n## Data Retrieval — Finskills API Calls\n\n### 1. All Commodity Spot Prices (Snapshot)\n```\nGET https://finskills.net/v1/free/commodity/prices\n```\nExtract the full commodity price dashboard:\n- Energy: `crude_oil_wti`, `crude_oil_brent`, `natural_gas`, `heating_oil`, `gasoline`\n- Metals: `gold`, `silver`, `platinum`, `copper`, `aluminum`, `iron_ore`\n- Agricultural: `corn`, `wheat`, `soybeans`, `coffee`, `cotton`, `sugar`\n\n### 2. Individual Commodity History (for trend analysis)\nFor key commodities, fetch 1-year daily history:\n```\nGET https://finskills.net/v1/free/commodity/history/{symbol}\n```\nTarget symbols: `WTI` (crude oil), `gold`, `copper`, `natgas`, `wheat`  \nExtract: date, price, change\n\n### 3. FRED Commodity Data Series\n```\nGET https://finskills.net/v1/free/commodity/fred\n```\nLists all available FRED commodity series.\n\n```\nGET https://finskills.net/v1/free/commodity/fred/{seriesId}\n```\nKey series to pull:\n- `DCOILWTICO`: WTI Crude Oil Daily Price\n- `GOLDAMGBD228NLBM`: Gold Price Daily\n- `PCOPPUSDM`: Copper Price Monthly\n- `TERMCBPER24NS`: Not applicable — use commodity endpoint instead\n\n### 4. IMF Commodity Index\n```\nGET https://finskills.net/v1/free/commodity/imf\n```\nExtract: IMF primary commodity price index (energy, metals, food sub-indices)  \nUse for: broad commodity cycle positioning (secular bull/bear)\n\n---\n\n## Analysis Workflow\n\n### Step 1 — Commodity Price Dashboard\n\nCreate a snapshot of all key commodities with direction signals:\n\nFor each commodity, classify:\n- **Near-term trend** (1-month): using price change % from history\n- **Medium-term trend** (3-month): using price change % from history\n- **Annual trend** (1-year): YTD change\n\n```\nDirection = {RALLYING ↑ / FALLING ↓ / FLAT ~} based on 1M change\n```\n\n### Step 2 — Key Macro Signal Derivation\n\n**Oil Price Signal (Economic Activity + Inflation):**\n- WTI > $90/bbl: Demand or supply-driven? Check supply context\n  - Demand-driven high prices (global growth): Bullish for equities (especially energy, materials)\n  - Supply-constriction high prices (OPEC cut): Stagflationary (bad for most assets)\n- WTI $60–$90: Normal regime, not a major headwind\n- WTI < $60: Disinflation signal; positive for airlines, transport, consumer discretionary\n\n**Gold Signal (Safe Haven + Real Rate Indicator):**\nGold is inversely correlated with real interest rates (nominal rate - inflation expectations):\n- Gold rising while rates rising: Unusual strength → fear of financial crisis or dollar weakness\n- Gold rising while rates stable/falling: Real rates falling → inflationary signal\n- Gold falling while rates rising: Normal correlation → risk-on, growth regime\n\n**Gold/Silver Ratio:**\n```\nGold_Silver_Ratio = gold_price / silver_price\n```\n- Ratio > 80: Economic uncertainty, risk-off (gold outperforms industrial silver)\n- Ratio < 60: Industrial demand strong, economic expansion (silver outperforms)\n\n**Copper Signal (\"Dr. Copper\" — Economic Barometer):**\n- Copper rising: Global manufacturing expansion, China construction activity strong\n- Copper falling: Global slowdown signal, watch emerging markets\n- Copper/Gold Ratio: Rising ratio → economic growth; Falling → risk-off\n\n```\nCopper_Gold_Ratio = copper_price (in cents/lb) / gold_price (in $/oz)\n```\nWhen ratio rises: Yields typically follow — confirms growth regime\nWhen ratio falls: Deflationary forces at work\n\n**Natural Gas Signal (Seasonal + Domestic):**\n- Winter: High nat gas = positive for utilities, LNG exporters, coal substitution\n- Summer: High nat gas = heat wave demand; positive for utilities\n\n**Agricultural Commodities Signal (Food Inflation):**\n- Wheat > $7/bushel: Food inflation pressure, CPI food component rising\n- Corn, Soy: Input cost for livestock, ethanol, food processing\n\n### Step 3 — Commodity Cycle Classification\n\nClassify the current phase of the commodity super-cycle:\n\n| Phase | Characteristics | Signal |\n|-------|----------------|--------|\n| **Early Bull** | Energy/metals rising from cyclical lows; USD weakening | Buy commodities, energy stocks, miners |\n| **Middle Bull** | Broad commodity rally; tight supply; high margins | Overweight materials, energy; watch inflation |\n| **Late Bull** | Speculative excess; soft commodities surging | Central bank tightening; equities under pressure |\n| **Early Bear** | Commodities peak; demand destruction; rate hike impact | Short energy, reduce materials |\n| **Middle Bear** | Broad selloff; energy struggling; metals weak | Defensive positioning |\n| **Late Bear** | Commodity lows; capex cuts building future supply deficit | Accumulate energy/materials for next cycle |\n\nAssign to current phase based on: direction of multiple commodity prices + interest rate environment.\n\n### Step 4 — Asset Class Implications Matrix\n\nBased on commodity signals, generate implications for asset classes:\n\n| Commodity Signal | Asset Class Implication |\n|----------------|------------------------|\n| Oil ↑ (demand) | Energy stocks ↑; Airlines ↓; Discretionary ↓; Oil-exporting EM ↑ |\n| Oil ↑ (supply cut) | All equities ↓; Gold ↑; TIPS ↑; Consumer sentiment ↓ |\n| Oil ↓ | Airlines ↑; Consumer discretionary ↑; Energy stocks ↓; EM exporters ↓ |\n| Gold ↑, Rates ↓ | Risk-off; Bonds ↑; USD ↓; Miners ↑ |\n| Gold ↓, Rates ↑ | Risk-on; Equities ↑; Value > Growth |\n| Copper ↑ | Industrials ↑; Emerging markets ↑; Materials ↑ |\n| Copper ↓ | Global slowdown; Defensive sectors ↑ |\n| Broad Agri ↑ | CPI food component ↑; Consumer staples mixed; EM stress |\n| Broad Commodity Rally | TIPS ↑; Energy ↑; Materials ↑; Value ↑ over Growth |\n| Broad Commodity Decline | Equities mixed; Discretionary ↑; Disinflation tailwind |\n\n### Step 5 — Sector-Level Impact\n\nMap to specific equity sectors:\n- **Energy (XLE)**: Directly correlated with WTI crude\n- **Materials (XLB)**: Copper, aluminum, iron ore, potash\n- **Industrials (XLI)**: Broad commodity demand signal\n- **Consumer Staples (XLP)**: Wheat, corn, sugar as input costs\n- **Consumer Discretionary (XLY)**: Gasoline price as consumer purchasing power headwind\n- **Utilities (XLU)**: Natural gas as fuel input cost\n- **Airlines**: Jet fuel (kerosene, highly correlated to crude) as major cost\n- **Miners/Gold stocks (GDX)**: Gold and silver price leverage\n\n---\n\n## Output Format\n\n```\n╔══════════════════════════════════════════════════════════════╗\n║    COMMODITY MACRO SIGNAL REPORT  —  {DATE}                 ║\n╚══════════════════════════════════════════════════════════════╝\n\n🛢️  ENERGY\n  WTI Crude Oil:   ${price}/bbl   {+/-}%  1M  {+/-}%  3M  {+/-}%  YTD\n  Brent Crude:     ${price}/bbl   {+/-}%  1M\n  Natural Gas:     ${price}/MMBtu {+/-}%  1M\n  Gasoline:        ${price}/gal   {+/-}%  1M\n  Oil Signal:  →  {DEMAND-DRIVEN SURGE / SUPPLY CUT SURGE / NORMAL RANGE / DEFLATIONARY DROP}\n\n🥇 PRECIOUS METALS\n  Gold:     ${price}/oz    {+/-}%  1M  {+/-}%  3M  {+/-}%  YTD\n  Silver:   ${price}/oz    {+/-}%  1M\n  Platinum: ${price}/oz    {+/-}%  1M\n  Gold/Silver Ratio: {ratio:.1f}  →  {RISK-OFF / NORMAL / RISK-ON}\n  Gold Signal: →  {SAFE HAVEN DEMAND / REAL RATES FALLING / NORMAL}\n\n⚙️  INDUSTRIAL METALS (\"Dr. Copper\")\n  Copper:   ${price}¢/lb   {+/-}%  1M  {+/-}%  3M\n  Aluminum: ${price}/ton   {+/-}%  1M\n  Iron Ore: ${price}/ton   {+/-}%  1M\n  Copper/Gold Ratio: {ratio:.4f}  →  {Growth signal rising / Declining = risk-off}\n  Industrial Signal: →  {EXPANSION / SLOWING / CONTRACTION}\n\n🌾 AGRICULTURAL\n  Corn:    ${price}/bu     {+/-}%  1M\n  Wheat:   ${price}/bu     {+/-}%  1M\n  Soybeans:${price}/bu     {+/-}%  1M\n  Coffee:  ${price}¢/lb    {+/-}%  1M\n  Agri Signal: →  {FOOD INFLATION PRESSURE / STABLE / DEFLATIONARY}\n\n📊 IMF COMMODITY INDICES\n  IMF All Commodities:  {index}  {+/-}%  3M\n  IMF Energy Sub-Index: {index}  {+/-}%  3M\n  IMF Metals Index:     {index}  {+/-}%  3M\n  IMF Food Index:       {index}  {+/-}%  3M\n  Cycle Phase: →  {EARLY BULL / MIDDLE BULL / LATE BULL / EARLY BEAR / LATE BEAR}\n\n💡 MACRO SYNTHESIS\n  Inflationary pressure:   {HIGH / MODERATE / LOW}\n  Growth signal:           {EXPANSION / MIXED / CONTRACTION}\n  USD implication:         {BEARISH on USD / NEUTRAL / BULLISH on USD}\n\n📈 ASSET CLASS IMPLICATIONS\n  OVERWEIGHT:   {asset classes and sectors benefiting from current commodity signals}\n  UNDERWEIGHT:  {asset classes hurt by current commodity signals}\n\n  Sector Playbook:\n    Energy (XLE):       {↑ Strong tailwind / → Neutral / ↓ Headwind}\n    Materials (XLB):    {↑ / → / ↓}\n    Industrials (XLI):  {↑ / → / ↓}\n    Airlines:           {↑ / → / ↓}\n    Consumer:           {↑ / → / ↓}\n    Gold Miners (GDX):  {↑ / → / ↓}\n\n🔍 KEY SIGNAL TO WATCH\n  {The one commodity ratio or indicator that best captures current macro regime transition,\n   and what a move above/below X level would imply for portfolio positioning.}\n```\n\n---\n\n## Limitations\n\n- Commodity spot prices may lag physical markets by 1 business day.\n- Supply-driven vs. demand-driven price changes require judgment — always consider news context.\n- Agricultural commodity prices are highly seasonal and weather-dependent.\n- The copper/gold ratio as a growth signal works best over multi-month periods, not day-to-day.\n\nFile v1.0.0:README.md\n\n# commodity-macro-signal\n\n> Analyze energy, metals, and agricultural commodity prices to extract macro signals for inflation, growth, and sector rotation — all via free-tier [Finskills API](https://finskills.net) commodity endpoints.\n\n[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)]()\n[![Plan](https://img.shields.io/badge/API%20Plan-Free-brightgreen.svg)](https://finskills.net/register)\n[![Category](https://img.shields.io/badge/category-macro-commodities-brown.svg)]()\n\n---\n\n## What This Skill Does\n\n1. Fetches a full commodity price dashboard: energy (WTI/Brent, NatGas), metals (Gold, Silver, Copper), agricultural (Wheat, Corn, Soybeans)\n2. Computes 1M/3M/YTD trends per commodity\n3. Calculates macro signal ratios: Gold/Silver ratio, Copper/Gold ratio (\"Dr. Copper\")\n4. Fetches FRED and IMF commodity indices for broader cycle context\n5. Classifies current commodity super-cycle phase (Early Bull → Late Bear)\n6. Maps commodity signals to sector and asset class implications (OW/N/UW)\n\n**All API endpoints used are on the free tier — no Pro plan required.**\n\n## Install\n\n```bash\nnpx skills add https://github.com/your-org/finskills-skills --skill commodity-macro-signal\n```\n\n## Quick Start\n\n```\nYou: What are commodity prices telling us about the macro environment?\nClaude: [Fetches all commodity prices + history + FRED series, computes ratios, outputs macro signal report]\n```\n\n## Example Triggers\n\n- `\"What's the signal from oil prices right now?\"`\n- `\"Is gold rising for good or bad reasons?\"`\n- `\"What is Dr. Copper saying about the economy?\"`\n- `\"Give me a commodities macro panel\"`\n- `\"Should I overweight energy or materials based on commodities?\"`\n\n## Key Signal Ratios\n\n| Ratio | Interpretation |\n|-------|---------------|\n| Gold/Silver > 80 | Risk-off, economic uncertainty |\n| Gold/Silver < 60 | Risk-on, industrial expansion |\n| Copper/Gold rising | Growth regime, yields following |\n| Copper/Gold falling | Deflationary / slowdown signal |\n| WTI > $90 | High inflation pressure or supply shock |\n| WTI < $60 | Disinflation, consumer spending tailwind |\n\n## API Endpoints Used (All Free)\n\n| Endpoint | Data |\n|----------|------|\n| `GET /v1/free/commodity/prices` | All commodity spot prices |\n| `GET /v1/free/commodity/history/{symbol}` | 1Y history for WTI, Gold, Copper |\n| `GET /v1/free/commodity/fred/{seriesId}` | FRED commodity series (DCOILWTICO, etc.) |\n| `GET /v1/free/commodity/imf` | IMF all-commodity + sub-indices |\n\n## Requirements\n\n- **Finskills API Key** ([register here](https://finskills.net)): [Register at finskills.net](https://finskills.net) (free tier available) — **free plan is sufficient**\n- **Claude** with skill support\n\n## License\n\nMIT — see [LICENSE](../LICENSE)\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn7ebwb8j890wdqw56b58x77w182snyh\",\n  \"slug\": \"commodity-macro-signal\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1776517507207\n}","readmeExcerpt":"Skill: commodity-macro-signal Owner: finskills Summary: Analyze energy, metals, and agricultural commodity markets alongside macro indicators to generate cross-asset macro signals. Tags: latest:1.0.1 Version history: v1.0.1 | 2026-04-18T15:47:52.044Z | user - Added a skill manifest block (metadata) including API key requirements, author, and homepage info. - Updated API key setup instructions for clarity and direct r","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"GET https://finskills.net/v1/free/commodity/prices"},{"language":"text","snippet":"GET https://finskills.net/v1/free/commodity/history/{symbol}"},{"language":"text","snippet":"GET https://finskills.net/v1/free/commodity/fred"},{"language":"text","snippet":"GET https://finskills.net/v1/free/commodity/fred/{seriesId}"},{"language":"text","snippet":"GET https://finskills.net/v1/free/commodity/imf"},{"language":"text","snippet":"Direction = {RALLYING ↑ / FALLING ↓ / FLAT ~} based on 1M change"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: Commodity Macro Signal\nversion: 1.0.2\ndescription: \"Analyze energy, metals, and agricultural commodity markets alongside macro indicators to generate cross-asset macro signals.\"\nauthor: finskills\nmetadata:\n  openclaw:\n    requires:\n      env:\n        - FINSKILLS_API_KEY\n    primaryEnv: FINSKILLS_API_KEY\n  homepage: https://github.com/finskills/commodity-macro-signal\n---\n\n# Commodity Macro Signal\n\nAnalyze global commodity markets to extract macro signals for inflation, growth,\nand supply chain dynamics using free-tier Finskills API data. Covers energy\n(crude oil, natural gas), precious metals (gold, silver), industrial metals\n(copper), agricultural products, and FRED/IMF commodity indices — then synthesizes\ninvestment implications across asset classes.\n\n---\n\n## Setup\n\n**API Key required** — [Register at https://finskills.net](https://finskills.net) to get your free key.  \nHeader: `X-API-Key: <your_api_key>`\n> **Get your API key**: Register at **https://finskills.net** — free tier available, Pro plan unlocks real-time quotes, history, and financials.\n\n---\n\n## When to Activate This Skill\n\nActivate when the user:\n- Asks about oil, gold, copper, natural gas, silver, or agricultural commodity prices\n- Wants to understand what rising/falling commodity prices mean for markets\n- Asks \"is this inflationary or deflationary?\"\n- Wants a commodity-driven macro analysis\n- Asks about Dr. Copper, gold/silver ratio, oil equity ratio\n- Wants to know how commodities affect specific sectors (energy, materials, airlines, etc.)\n\n---\n\n## Data Retrieval — Finskills API Calls\n\n### 1. All Commodity Spot Prices (Snapshot)\n```\nGET https://finskills.net/v1/free/commodity/prices\n```\nExtract the full commodity price dashboard:\n- Energy: `crude_oil_wti`, `crude_oil_brent`, `natural_gas`, `heating_oil`, `gasoline`\n- Metals: `gold`, `silver`, `platinum`, `copper`, `aluminum`, `iron_ore`\n- Agricultural: `corn`, `wheat`, `soybeans`, `coffee`, `cotton`, `sugar`\n\n### 2. Individual Commodity History (for trend analysis)\nFor key commodities, fetch 1-year daily history:\n```\nGET https://finskills.net/v1/free/commodity/history/{symbol}\n```\nTarget symbols: `WTI` (crude oil), `gold`, `copper`, `natgas`, `wheat`  \nExtract: date, price, change\n\n### 3. FRED Commodity Data Series\n```\nGET https://finskills.net/v1/free/commodity/fred\n```\nLists all available FRED commodity series.\n\n```\nGET https://finskills.net/v1/free/commodity/fred/{seriesId}\n```\nKey series to pull:\n- `DCOILWTICO`: WTI Crude Oil Daily Price\n- `GOLDAMGBD228NLBM`: Gold Price Daily\n- `PCOPPUSDM`: Copper Price Monthly\n- `TERMCBPER24NS`: Not applicable — use commodity endpoint instead\n\n### 4. IMF Commodity Index\n```\nGET https://finskills.net/v1/free/commodity/imf\n```\nExtract: IMF primary commodity price index (energy, metals, food sub-indices)  \nUse for: broad commodity cycle positioning (secular bull/bear)\n\n---\n\n## Analysis Workflow\n\n### Step 1 — Commodity Price Dashboard\n\nCreate a snapshot of all key commodities with direc"},{"path":"README.md","content":"# commodity-macro-signal\n\n> Analyze energy, metals, and agricultural commodity prices to extract macro signals for inflation, growth, and sector rotation — all via free-tier [Finskills API](https://finskills.net) commodity endpoints.\n\n[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)]()\n[![Plan](https://img.shields.io/badge/API%20Plan-Free-brightgreen.svg)](https://finskills.net/register)\n[![Category](https://img.shields.io/badge/category-macro-commodities-brown.svg)]()\n\n---\n\n## What This Skill Does\n\n1. Fetches a full commodity price dashboard: energy (WTI/Brent, NatGas), metals (Gold, Silver, Copper), agricultural (Wheat, Corn, Soybeans)\n2. Computes 1M/3M/YTD trends per commodity\n3. Calculates macro signal ratios: Gold/Silver ratio, Copper/Gold ratio (\"Dr. Copper\")\n4. Fetches FRED and IMF commodity indices for broader cycle context\n5. Classifies current commodity super-cycle phase (Early Bull → Late Bear)\n6. Maps commodity signals to sector and asset class implications (OW/N/UW)\n\n**All API endpoints used are on the free tier — no Pro plan required.**\n\n## Install\n\nAdd this skill via [ClawHub](https://clawhub.ai/finskills/commodity-macro-signal):\n\n1. Visit **[https://clawhub.ai/finskills/commodity-macro-signal](https://clawhub.ai/finskills/commodity-macro-signal)**\n2. Click **Download zip** and follow the setup instructions\n3. Set your API key: `FINSKILLS_API_KEY=your_key_here`\n\n## Quick Start\n\n```\nYou: What are commodity prices telling us about the macro environment?\nClaude: [Fetches all commodity prices + history + FRED series, computes ratios, outputs macro signal report]\n```\n\n## Example Triggers\n\n- `\"What's the signal from oil prices right now?\"`\n- `\"Is gold rising for good or bad reasons?\"`\n- `\"What is Dr. Copper saying about the economy?\"`\n- `\"Give me a commodities macro panel\"`\n- `\"Should I overweight energy or materials based on commodities?\"`\n\n## Key Signal Ratios\n\n| Ratio | Interpretation |\n|-------|---------------|\n| Gold/Silver > 80 | Risk-off, economic uncertainty |\n| Gold/Silver < 60 | Risk-on, industrial expansion |\n| Copper/Gold rising | Growth regime, yields following |\n| Copper/Gold falling | Deflationary / slowdown signal |\n| WTI > $90 | High inflation pressure or supply shock |\n| WTI < $60 | Disinflation, consumer spending tailwind |\n\n## API Endpoints Used (All Free)\n\n| Endpoint | Data |\n|----------|------|\n| `GET /v1/free/commodity/prices` | All commodity spot prices |\n| `GET /v1/free/commodity/history/{symbol}` | 1Y history for WTI, Gold, Copper |\n| `GET /v1/free/commodity/fred/{seriesId}` | FRED commodity series (DCOILWTICO, etc.) |\n| `GET /v1/free/commodity/imf` | IMF all-commodity + sub-indices |\n\n## Requirements\n\n- **Finskills API Key**: [Register at finskills.net](https://finskills.net) (free tier available) — **free plan is sufficient**\n- **Claude** with skill support\n\n## License\n\nMIT — see [LICENSE](../LICENSE)"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7ebwb8j890wdqw56b58x77w182snyh\",\n  \"slug\": \"commodity-macro-signal\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1776527272044\n}"},{"path":"skill-card.md","content":"## Description:\n\nAnalyze energy, metals, and agricultural commodity markets alongside macro indicators to generate cross-asset macro signals.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[finskills](https://clawhub.ai/user/finskills)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers, analysts, and financial research teams use this skill to fetch Finskills commodity data and produce macro signal reports about inflation, growth, sector rotation, and asset-class implications.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Commodity macro interpretations may be mistaken for personalized trading advice.\n\nMitigation: Frame results as informational market analysis and avoid automated trading or individualized portfolio recommendations.\n\nRisk: The skill requires a Finskills API key for commodity data requests.\n\nMitigation: Keep FINSKILLS_API_KEY in environment configuration and avoid exposing it in prompts, logs, or generated reports.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/finskills/skills/commodity-macro-signal)\n- [Project homepage](https://github.com/finskills/commodity-macro-signal)\n- [Finskills API registration](https://finskills.net)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, API calls, Guidance]\n\n**Output Format:** [Markdown market analysis report with commodity snapshots, signal ratios, cycle classification, and sector implications.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires FINSKILLS_API_KEY; outputs should be treated as informational market analysis, not automated trading or personalized financial advice.]\n\n## Skill Version(s):\n\n1.0.1 (source: server release metadata; target metadata agrees)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Analyze energy, metals, and agricultural commodity markets alongside macro indicators to generate cross-asset macro signals. Skill: commodity-macro-signal Owner: finskills Summary: Analyze energy, metals, and agricultural commodity markets alongside macro indicators to generate cross-asset macro signals. Tags: latest:1.0.1 Version history: v1.0.1 | 2026-04-18T15:47:52.044Z | user - Added a skill manifest block (metadata) including API key requirements, author, and homepage info. - Updated API key setup instructions for clarity and direct r","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1394,"uniquenessScore":46,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-12T00:53:42.229Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-12T00:53:42.229Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-13T09:32:02.236Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}