# USStats

Query the configured long-run US almanac (90+ annual series on economy, debt, cost of...

- Repository: https://github.com/danielmiessler/LifeOS (19669 stars)
- Category: Data and ML
- License: MIT
- Last updated: 2026-10-28
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add danielmiessler/LifeOS --skill USStats -g -a claude-code -y`
Codex: `npx skills add danielmiessler/LifeOS --skill USStats -g -a codex -y`
Cursor: `npx skills add danielmiessler/LifeOS --skill USStats -g -a cursor -y`
Gemini CLI: `npx skills add danielmiessler/LifeOS --skill USStats -g -a gemini-cli -y`

## Description

Query the configured long-run US almanac (90+ annual series on economy, debt, cost of living, health, crime, family, trust, energy, many back to the 1940s: trends, verdicts, movers, correlations, freshness vs source datasets), and pull 66 current indicators from FRED, EIA and Treasury into the local US-Common-Metrics dataset for a 10y/5y/2y/1y read of the economy now. USE WHEN usstats, US stats, US indicators, long-run US trends, is X getting better or worse in America, US crime trend, wage trend, inflation history, correlate US indicators, compare decades, is the usstats data fresh, how is the economy, economic overview, economic metrics, economic trends, GDP, inflation, unemployment, gas prices, mortgage rates, FRED, US metrics, refresh data, refresh the economic data, refresh US-Common-Metrics. NOT FOR pathogen surveillance, personal finances or investments, rebuilding or publishing the almanac site itself, refreshing our data sites (DataRefresh).

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# USStats

**Contents:** Ideal State · Intent Routing · Data Contract · Data & Config · Quick Reference · Gotchas · Examples

Query and analyze the annual US indicator dataset at the almanac endpoint named by `data_url` in the install config (`<configRoot>/LIFEOS/USER/CUSTOMIZATIONS/SKILLS/USStats/Config.md`), read-only, keyless, no local repo dependencies. Every series carries publisher provenance (`source`, `sourceUrl`, `note`) and a `goodDirection` flag that lets the tool answer "better or worse?" deterministically.

It also reads the current US economy straight from the government APIs (ported from the retired USMetrics skill, 2026-10-10). The one count and source list for that side, read from the updater's `METRICS` config in `Tools/UpdateSubstrateMetrics.ts` on 2026-10-11: UpdateData fetches 66 indicators in 9 categories (Economic Output, Inflation, Employment, Housing, Consumer, Financial, Trade, Fiscal, Demographics) through three APIs, FRED (64 series, carrying BLS, BEA, Census, Fed and Treasury data), EIA (gas price) and Treasury FiscalData (total public debt), into the local US-Common-Metrics dataset (`US-Common-Metrics.md`, `us-metrics-current.csv`, `us-metrics-historical.csv`). The master document lists 68 metrics in 10 categories; its Health & Crisis rows (CDC WONDER, EPA AQS) have no fetcher and stay placeholders, and a master row the updater did not fetch is named, never silently counted. GetCurrentState produces a multi-timeframe (10y/5y/2y/1y) trend report with cross-metric analysis, pattern detection, and research recommendations from its own FRED and EIA fetch, so it does not depend on an UpdateData run. The almanac answers "over decades, annually"; the live side answers "right now, monthly and weekly".

## Ideal State

The rest: https://github.com/danielmiessler/LifeOS/blob/HEAD/LifeOS/install/skills/USStats/SKILL.md