pp-american-reindustrialization

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/other/american-reindustrialization/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# American Reindustrialization — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `american-reindustrialization-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install american-reindustrialization --cli-only
   ```
2. Verify: `american-reindustrialization-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/other/american-reindustrialization/cmd/american-reindustrialization-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

## When to Use This CLI

Reach for this CLI when an agent or analyst needs to slice, join, or analyze the americanreindustrialization.com company directory and jobs board beyond what the website's filter UI exposes. The local SQLite store enables composed cross-resource filters (jobs at companies with property X), aggregate analytics (sector × state heatmaps, funding × sector crosstabs, salary distributions), and diff over time (whats-new since a prior sync). Pair `--select` with `--json` whenever an agent only needs a subset of the ~30 fields per company.

## When Not to Use This CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.

## Unique Capabilities

These capabilities aren't available in any other tool for this API.

### Local state that compounds
- **`whats-new`** — Show companies and jobs added or updated since a date you provide, so a weekly sweep takes one command instead of an eyeball-the-list session.

  _Reach for this when an analyst or agent needs week-over-week deltas across the directory; the site offers no such view._

  ```bash
  american-reindustrialization-pp-cli whats-new --since 2026-05-12 --json
  ```

### Cross-entity local queries
- **`openings find`** — Filter the jobs board by work_mode, experience_level, salary floor, state, company size, sector, and posted-since in a single query — combinations the website's UI cannot express.

  _Use this when a user wants the shortlist instead of 25 paginated pages; cross-resource filters are this CLI's reason to exist._

  ```bash
  american-reindustrialization-pp-cli openings find --work-mode remote --experience senior --salary-min 150000 --state TX --json
  ```
- **`companies top-hiring`** — Rank companies by jobs_count descending, with optional filters by sector, state, or funding_stage — the site has no ranking view.

  _Reach for this when a job seeker or recruiter wants 'who has the most openings in sector X right now'._

  ```bash
  american-reindustrialization-pp-cli companies top-hiring --sector robotics --limit 10 --json
  ```
- **`companies profile`** — Single-shot rich profile for one company: full fields plus that company's open jobs plus similar companies (same primary_sector and employee_range bucket).

  _Use this when a single named company needs full context plus peers — research, due diligence, competitor scans._

  ```bash
  american-reindustrialization-pp-cli companies profile harmony-ai --json
  ```

### Ecosystem analytics
- **`analytics sector-heatmap`** — Crosstab of primary_sector × HQ state with company counts (optionally weighted by jobs_count or filtered by funding_stage), revealing the geographic shape of each sector.

  _Pull this when answering 'where is sector X clustering' or 'which states are bidding loudest on hiring in sector Y'._

  ```bash
  american-reindustrialization-pp-cli analytics sector-heatmap --funding-stage seed --weight jobs --json
  ```
- **`analytics funding-by-sector`** — Crosstab of funding_stage × primary_sector with company counts and median employee_range, exposing where capital is concentrating.

  _Use this when an investor needs the capital map across the reindustrialization directory._

  ```bash
  american-reindustrialization-pp-cli analytics funding-by-sector --json
  ```
- **`analytics geo-clusters`** — Grid-bucket companies by lat/lon (default 50km cells) and emit cluster centroid, member count, member companies, and the dominant sector per cluster.

  _Pull this for 'which metro is the densest cluster in sector X' style questions; the site has no map view._

  ```bash
  american-reindustrialization-pp-cli analytics geo-clusters --state TX --radius-km 50 --json
  ```
- **`openings salary-stats`** — p25 / p50 / p75 of midpoint salary across filtered jobs, with null-salary count reported separately so missing data is honest.

  _Use this when a job seeker or comp analyst wants band ranges, not individual postings._

  ```bash
  american-reindustrialization-pp-cli openings salary-stats --sector robotics --experience senior --json
  ```
- **`companies cohorts`** — Bucket companies by founded_year (default 5-year buckets) with company counts and the top-3 sectors per cohort.

  _Reach for this when writing about 'companies founded since 2020 in the reindustrialization wave' or tracking ecosystem age over time._

  ```bash
  american-reindustrialization-pp-cli companies cohorts --bucket 5 --json
  ```

## Command Reference

**categories** — Top-level sectors (hierarchical via parent_id)

- `american-reindustrialization-pp-cli categories counts` — Map of category_id -> company count
- `american-reindustrialization-pp-cli categories get` — Get one category by slug
- `american-reindustrialization-pp-cli categories list` — List every category (bare array)
- `american-reindustrialization-pp-cli categories search` — Search categories by query string

**companies** — US-based companies driving reindustrialization (manufacturing, robotics, advanced materials, supply chains)

- `american-reindustrialization-pp-cli companies get` — Get one company by slug (returns the full object directly, not wrapped)
- `american-reindustrialization-pp-cli companies list` — List companies with pagination and optional server-side filters
- `american-reindustrialization-pp-cli companies search` — Full-text search across company names and descriptions; returns a bare array

**news** — News feed (currently empty upstream; reserved for future API population)

- `american-reindustrialization-pp-cli news` — List news items (returns a bare array; empty at capture)

**openings** — Open job listings aggregated from companies in the directory

- `american-reindustrialization-pp-cli openings categories` — Autocomplete list of categories that have at least one opening
- `american-reindustrialization-pp-cli openings companies` — Autocomplete list of {id, name} for companies that currently have open openings
- `american-reindustrialization-pp-cli openings get` — Get one job opening by slug
- `american-reindustrialization-pp-cli openings list` — List job openings with pagination and optional server-side filters (work_mode and experience_level are honored;...
- `american-reindustrialization-pp-cli openings