Import listings

.agents/skills/import-listings/SKILL.md — 114 lines of instruction that ship inside the starter. This page is generated from it, so it says what the skill does without republishing it.

When an agent picks this up

The skill description, verbatim — this is the text an agent matches your request against:

Bulk-import listings into a ZeroDirs directory site from a CSV or JSON file with pnpm listings:import. Covers column mapping, the dry run, the unknown-category hard error, the unknown-tag warning, logo and date rules, and slug collisions. Use when asked to import a spreadsheet, seed a directory from a data file, or re-import a corrected export.

What it walks through

1. Always dry-run first
2. The two failure modes to know
3. Column mapping
4. Field rules
5. JSON input
6. Verify

Commands it runs

pnpm listings:import <file.csv|file.json>
pnpm listings:import data.csv --dry-run      # always do this first
pnpm listings:import data.csv                # then write
pnpm listings:import data.csv --dry-run
pnpm listings:import data.csv
pnpm check:config       # config + the static-file budget estimate for the new count
pnpm build
pnpm check:config

Files it touches

scripts/import.ts · src/loaders/normalize.ts · site.config.ts · tests/fixtures/import-sample.csv · src/components/listing/Detail.astro · src/content/listings/

Using it

Skills load themselves — you describe the outcome, not the skill. “Add a Compliance category with an icon and seed it” is enough for an agent that can see .agents/skills/; Claude Code reads .claude/skills/, which pnpm skills:sync mirrors from .agents/ on every install. See Working with an agent.