usmetrics

name USMetrics version 1.0.20 description Analyze and update 68 US economic and social indicators from five government APIs (FRED, EIA, Treasury, BLS, Census) across 10 categories: GDP, Inflation, Employment, Housing, Consumer Finance, Markets, Trade, Government/Fiscal, Demographics, Health. Two workflows: UpdateData, GetCurrentState (10y/5y/2y/1y trend analysis). USE WHEN GDP, inflation, unemployment, economic metrics, gas prices, how is the economy, refresh data, FRED, US metrics, economic trends. NOT FOR pathogen surveillance. Customization Before executing, check for user customizations at: ~/.claude/LIFEOS/USER/CUSTOMIZATIONS/SKILLS/USMetrics/ If this directory exists, load and apply any PREFERENCES.md, configurations, or resources found there. These override default behavior. If the directory does not exist, proceed with skill defaults. 🚨 MANDATORY: Voice Notification (REQUIRED BEFORE ANY ACTION) You MUST send this notification BEFORE doing anything else when this skill is invoked. Send voice notification : curl -s -X POST http://localhost:31337/notify \ -H "Content-Type: application/json" \ -d '{"message": "Running the WORKFLOWNAME workflow in the USMetrics skill to ACTION"}' \ > /dev/null 2>&1 & Output text notification : Running the **WorkflowName** workflow in the **USMetrics** skill to ACTION... This is not optional. Execute this curl command immediately upon skill invocation. US Metrics - Economic & Social Indicator Analysis What It Does Pulls 68 US economic and social indicators from five government APIs (FRED, EIA, Treasury, BLS, Census) across 10 categories — GDP, Inflation, Employment, Housing, Consumer Finance, Markets, Trade, Government/Fiscal, Demographics, Health — and analyzes them. Two workflows: UpdateData fetches live values into the Substrate dataset; GetCurrentState produces a multi-timeframe (10y/5y/2y/1y) trend overview with cross-metric correlation, pattern detection, and research recommendations. The Problem The numbers that tell you how the economy is actually doing are scattered across five federal agencies, each with its own API, its own update cadence, and its own publication lag. Pulling "how is the economy?" together by hand means hitting FRED, EIA, Treasury, BLS, and Census separately, normalizing the results, and lining up trends across different timeframes — slow, error-prone, and easy to present stale or preliminary data as if it were final. This skill collects all 68 indicators into one dataset and reads the trends across four timeframes at once. How It Works It analyzes U.S. economic and social metrics using the Substrate US-Common-Metrics dataset and provides trend analysis, cross-metric correlation, pattern detection, and research recommendations. UpdateData must run first so the dataset is current; GetCurrentState then reads the dataset and computes the trends. Data Source All metrics sourced from: Location: Configure your data directory path (e.g., ${LIFEOS_DIR}/data/US-Common-Metrics/ ) Master Document: US-Common-Metrics.md (68 metrics across 10 categories) Source Documentation: source.md (full methodology) Underlying APIs: FRED, EIA, Treasury FiscalData, BLS, Census, CDC, EPA Workflow Routing When executing a workflow, output this notification directly: Running the **WorkflowName** workflow in the **USMetrics** skill to ACTION... Available Workflows Workflow Trigger File UpdateData "Update metrics", "refresh data", "pull latest", "update Substrate" — fetch live data from APIs and update Substrate dataset Workflows/UpdateData.md GetCurrentState "How is the economy?", "economic overview", "get current state", "US metrics analysis" — multi-timeframe trend overview Workflows/GetCurrentState.md Workflows UpdateData Full documentation: Workflows/UpdateData.md Purpose: Fetch live data from FRED, EIA, Treasury APIs and populate the Substrate US-Common-Metrics dataset files. This must run before GetCurrentState to ensure data is current. Execution: bun ${LIFEOS_SKILL_DIR} /Tools/UpdateSubstrateMetrics.ts Outputs: US-Common-Metrics.md - Updated with current values us-metrics-current.csv - Machine-readable snapshot us-metrics-historical.csv - Appended time series Trigger phrases: "Update the US metrics" "Refresh the economic data" "Pull latest metrics" "Update Substrate dataset" GetCurrentState Full documentation: Workflows/GetCurrentState.md Produces: A comprehensive overview document analyzing: 10-year, 5-year, 2-year, and 1-year trends for all major metrics Cross-category interplay analysis Pattern detection and anomalies Research recommendations Trigger phrases: "How is the US economy doing?" "Give me an economic overview" "What's the current state of US metrics?" "Analyze economic trends" "US metrics report" Metric Categories Covered Economic Output & Growth - GDP, industrial production, retail sales Inflation & Prices - CPI, PCE, gas prices, oil prices Employment & Labor - Unemployment, payrolls, jobless claims, quit rate Housing - Home prices, mortgage rates, housing starts Consumer & Personal Finance - Sentiment, saving rate, credit Financial Markets - Interest rates, Treasury yields, volatility Trade & International - Trade balance, USD index Government & Fiscal - Federal debt, budget deficit, spending Demographics & Social - Population, inequality, poverty Health & Crisis - Deaths of despair, air quality, life expectancy API Keys Required For live data fetching: FRED_API_KEY - Federal Reserve Economic Data EIA_API_KEY - Energy Information Administration Tools Tool Purpose Tools/UpdateSubstrateMetrics.ts Primary - Fetch all metrics, update Substrate files Tools/FetchFredSeries.ts Fetch historical data from FRED API Tools/GenerateAnalysis.ts Generate analysis report from Substrate data Examples User: "How is the US economy doing? Give me a full analysis." → Invoke GetCurrentState workflow → Fetch current + historical data for all metrics → Calculate 10y/5y/2y/1y trends → Analyze cross-metric correlations → Identify patterns and anomalies → Generate research recommendations → Output comprehensive markdown report Output Format The GetCurrentState workflow produces a structured markdown document: # US Economic State Analysis **Generated:** [timestamp] **Data Sources:** FRED, EIA, Treasury, BLS, Census ## Executive Summary [Key findings in 3-5 bullets] ## Trend Analysis by Category ### Economic Output [10y/5y/2y/1y trends with analysis] ... ## Cross-Metric Analysis [Correlations, leading indicators, divergences] ## Pattern Detection [Anomalies, regime changes, emerging trends] ## Research Recommendations [Suggested areas for deeper investigation] Gotchas 68 indicators from 5 agencies (FRED, EIA, Treasury, BLS, Census). Each has its own API rate limits and data freshness. Economic data has publication lag. GDP is quarterly with revisions. Jobs data is monthly. Don't present preliminary data as final. Cross-metric correlation is suggestive, not causal. Never claim one metric caused another. Execution Log After completing any workflow, append a single JSONL entry: echo '{"ts":"' $( date -u +%Y-%m-%dT%H:%M:%SZ) '","skill":"USMetrics","workflow":"WORKFLOW_USED","input":"8_WORD_SUMMARY","status":"ok|error","duration_s":SECONDS}' >> ~/.claude/LIFEOS/MEMORY/SKILLS/execution.jsonl Replace WORKFLOW_USED with the workflow executed, 8_WORD_SUMMARY with a brief input description, and SECONDS with approximate wall-clock time. Log status: "error" if the workflow failed.