Menu

Individual skill

USStats

0upvotes

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).

LifeOS/install/skills/USStats/SKILL.md

Read pinned source

Source commit b7efec97d8c3885feee285bee468c35602fb0606

What was checked

Matches the observed repository HEAD
Yes
Scanner rules are current
Yes
Repository scan complete
No
Skill scan complete
No
Observed behavior
Network or broad shell
Last checked
Nov 9, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

Standard SKILL.md format has not been attested at this commit. No installation command is available; inspect the source.

Repository context

Repository stars (not skill ratings)
19,781
Repository last updated
Nov 5, 2026
License
MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files
Read excerpt

# 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

- Every answer about a US indicator rests on this session's tool output from the live dataset, names the publisher of each quoted series, and judges better or worse only through `goodDirection`.
- Year-to-date values, methodology breaks in `note`, base effects behind large percentage moves and the correlation-is-not-causation caveat reach the reader whenever they touch the numbers quoted.
- A freshness question gets a per-upstream fresh or stale verdict from a `--fresh` run, and nothing in the skill ever writes to the site or its upstream datasets.
- Every live-economy number reported is current and carries its period and source, whether it came from GetCurrentState's own FRED and EIA fetch or from the dataset UpdateData refreshed, and preliminary or stale figures are labelled as such, never presented as final.
Back to top