fulcra-csvlisted
Install: claude install-skill ashfulcra/fulcra-tools
# fulcra-csv — Import any CSV into Fulcra
`fulcra-csv` is a small CLI that maps CSV columns onto Fulcra annotation events. It's the foundation `fulcra-media-helpers` uses for its `generic-csv` importer, but it works standalone for **any** kind of data: weights, moods, expenses, water intake, custom logs.
This skill teaches you (the AI agent) how to import a CSV into the right Fulcra annotation type for a given user data shape.
---
## Where to start — the re-entrancy probes
Before running an import, probe how far this user already got. The states are a prefix of
the import flow — **authed? → target def exists? → anything-to-import? → already landed?** — so
enter at the **first probe that fails** (per the repo's skill-quality pattern,
`docs/skill-quality-pattern.md`). Every state is safely re-enterable: re-running an import produces
the same deterministic source_ids, and the importer dedups against a readback of existing source_ids
before posting (client-side, in `run_import`; see "Critical invariant" below), so there is never a
penalty for re-probing or re-importing.
| Probe (run in order) | Command | Passes when | If it fails, enter at |
|---|---|---|---|
| Authed? | `fulcra auth print-access-token` | exits 0 and prints a non-empty token (the CLI mints/refreshes it; `FULCRA_ACCESS_TOKEN` in the env also satisfies this) | **AUTH** — tell the user to run `fulcra auth login` (interactive browser flow); see "Fulcra Life API auth" below |
| Target picked + def exists? | for