Customization
Before executing, check for user customizations at: ~/.claude/PAI/USER/SKILLCUSTOMIZATIONS/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:8888/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
Purpose: Analyze U.S. economic and social metrics using the Substrate US-Common-Metrics dataset. Provides trend analysis, cross-metric correlation, pattern detection, and research recommendations.
Data Source
All metrics sourced from:
- Location: Configure your data directory path (e.g.,
${PAI_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 | Description | Use When |
|---|---|---|
| UpdateData | Fetch live data from APIs and update Substrate dataset | "Update metrics", "refresh data", "pull latest", "update Substrate" |
| GetCurrentState | Comprehensive economic overview with multi-timeframe trend analysis | "How is the economy?", "economic overview", "get current state", "US metrics analysis" |
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 ~/.claude/skills/USMetrics/Tools/UpdateSubstrateMetrics.tsOutputs:
US-Common-Metrics.md- Updated with current valuesus-metrics-current.csv- Machine-readable snapshotus-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 DataEIA_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 |
Example Usage
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 reportOutput 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]