virtualian/pai/usmetrics

Customization

Before executing, check for user customizations at: ~/.claude/skills/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.

1. Send voice notification:

``bash 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 & ``

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

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/update-substrate-metrics.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

1. Economic Output & Growth - GDP, industrial production, retail sales
2. Inflation & Prices - CPI, PCE, gas prices, oil prices
3. Employment & Labor - Unemployment, payrolls, jobless claims, quit rate
4. Housing - Home prices, mortgage rates, housing starts
5. Consumer & Personal Finance - Sentiment, saving rate, credit
6. Financial Markets - Interest rates, Treasury yields, volatility
7. Trade & International - Trade balance, USD index
8. Government & Fiscal - Federal debt, budget deficit, spending
9. Demographics & Social - Population, inequality, poverty
10. 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

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 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]