us-census-data SKILL.md skillA

us-census-data from misterclean/ai-plugins is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add misterclean/ai-plugins/us-census-data@v1.1.0

Pins v1.1.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
misterclean/ai-plugins
Path
skills/us-census-data/SKILL.md
Versions recorded
4
Latest version
v1.1.0, committed Sep 20, 2026
First version recorded
Jan 14, 2026
Size
7,802 bytes
Repository stars
3
License
MIT

This skill should be used when the user asks to "get Census data", "query American Community Survey", "find ACS data", "get population by state", "query Decennial Census", "find Census variables", "get median income data", "download demographic data", "Census API query", "get housing data from Census", or mentions US Census Bureau data (demographics, income, poverty, education, housing, population estimates, etc.).

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# US Census Data Skill

Query demographic, economic, housing, and population data from the US Census Bureau API. Supports American Community Survey (ACS), Decennial Census, and Population Estimates.

## Prerequisites

Before querying, check if the user has an API key:

1. Look for `CENSUS_API_KEY` in the user's `.env` file
2. If found, append to requests: `&key=<api_key>`
3. If not found, instruct the user to:
   - Register at https://api.census.gov/data/key_signup.html
   - Add to `.env`: `CENSUS_API_KEY=your_key_here`

The API works without a key for testing but is rate-limited and may block requests.

## Quick Start

The Census API is at `api.census.gov`. Queries require:
1. **Dataset path**: `/data/{year}/{dataset}` (e.g., `/data/2022/acs/acs5`)
2. **Variables**: `?get=NAME,B01001_001E` (variable codes)
3. **Geography**: `&for=county:*&in=state:17` (FIPS codes)
4. **API Key**: `&key=YOUR_KEY` (required for production use)

## Workflow

### Step 1: Clarify the Data Need

Ask the user:
- **Topic**: What data? (population, income, housing, education, poverty, etc.)
- **Geography**: What level? (nation, state, county, tract, block group, ZCTA?)
- **Time period**: Which year(s)?
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add misterclean/ai-plugins/us-census-data@sha256:0c684b6b632c867a

The line at the top of this page pins the label v1.1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_adiayjkhq7svgr2g.svg)](https://markdownregistry.com/a/art_adiayjkhq7svgr2g)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Jan 14, 2026 and Sep 20, 2026, about one every 83 days.

versioncommittedcommitsizeaudit
v1.1.0 latest2026-09-20 8890776 7,802 BA view · diff
v1.1.02026-01-18 aeac250 7,788 BA view · diff
v1.0.02026-01-14 91dd2d8 7,596 BA view · diff
v1.0.02026-01-14 dd5a939 7,650 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7802 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

misterclean/ai-plugins · 3 stars · license MIT · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_adiayjkhq7svgr2g
GET https://markdownregistry.com/api/v1/resolve?ref=misterclean/ai-plugins/us-census-data
GET https://markdownregistry.com/api/v1/blob/0c684b6b632c867a4012a7b7edab239c453637759a4e4c76690a672d994174bd

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from misterclean/ai-plugins

AGENTS.md AGENTS.md file
misterclean/ai-plugins · AGENTS.md
git:20260920.8890776 · audit A · 3 stars
bluesky-bot SKILL.md skill
misterclean/ai-plugins · skills/bluesky-bot/SKILL.md · Build, improve, or operate Bluesky bots that publish source-backed records, changes, periodic observations, or…
v1.0.0 · audit A · 3 stars
chicago-data-portal SKILL.md skill
misterclean/ai-plugins · skills/chicago-data-portal/SKILL.md · This skill should be used when the user asks to "query Chicago data", "find Chicago datasets", "get Chicago crime…
v1.1.0 · audit A · 3 stars
chicago-transit-duckdb SKILL.md skill
misterclean/ai-plugins · skills/chicago-transit-duckdb/SKILL.md · Analyze and efficiently query CTA bus, CTA L train, and Metra vehicle-position archives from chicagotransitalerts.app…
v1.0.0 · audit A · 3 stars
cook-county-data-portal SKILL.md skill
misterclean/ai-plugins · skills/cook-county-data-portal/SKILL.md · This skill should be used when the user asks to "query Cook County data", "find Cook County datasets", "get property…
v1.1.0 · audit A · 3 stars
gridstatus-api SKILL.md skill
misterclean/ai-plugins · skills/gridstatus-api/SKILL.md · This skill should be used when the user asks to "get electricity data", "query grid data", "get LMP prices", "fetch…
v1.3.0 · audit A · 3 stars
housing-copywriter SKILL.md skill
misterclean/ai-plugins · skills/housing-copywriter/SKILL.md · This skill should be used when the user asks to "write marketing copy", "create social media posts", "write a blog…
v1.0.0 · audit A · 3 stars

Every file in misterclean/ai-plugins

Browse by kind, by grade A, or by owner.