# Import State Handler

> Use when the user asks import-state-handler to process an import job. Do not activate for generic CSV questions.

- Skill: `igapyon/import-state-handler` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add igapyon/import-state-handler`
- Raw SKILL.md: https://api.skillmd.com/api/skills/igapyon/import-state-handler/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: igapyon (https://skillmd.com/u/igapyon)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/igapyon/import-state-handler

---


# import-state-handler

Start in `pending`. If schema validation fails, transition to `rejected` and
stop. If validation succeeds but the remote API returns 429, wait for the
`Retry-After` value and retry at most twice. After the second 429, transition to
`deferred`. For any other API error, transition to `failed` without retry. When
all records are accepted, transition to `completed` and write `receipt.json`.

Never write `receipt.json` in `rejected`, `deferred`, or `failed` states. Return
the final state, retry count, and receipt path or absence.

