# Batch

> Process multiple items with progress tracking, checkpointing, and failure recovery.

- Skill: `xyva-yuangui/batch` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add xyva-yuangui/batch`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xyva-yuangui/batch/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: xyva-yuangui (https://skillmd.com/u/xyva-yuangui)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xyva-yuangui/batch

---


## Before Starting

1. **Dry run:** Test with 2-3 items first
2. **Count:** "Processing 47 items, ~2 min estimated"
3. **Confirm destructive ops:** "This will delete 200 files. Proceed?"

## During Processing

- **Progress every 10 items:** "23/47 complete (49%)"
- **Checkpoint every 10-50 items:** Save state to resume if interrupted
- **On error:** Log it, continue with rest (don't abort entire batch)

## After Completion

Always report:
```
✅ 44 succeeded
❌ 3 failed (saved to failed.json for retry)
```

## Error Handling

| Error | Action |
|-------|--------|
| Timeout, rate limit | Retry 3x with backoff (1s, 2s, 4s) |
| Bad format, missing data | Skip, log, continue |
| Auth failed, disk full | Abort entire batch |

Check `strategies.md` for parallel vs sequential decision matrix.
Check `errors.md` for retry logic and rollback patterns.

---

**Related:** For delegating to sub-agents, see `delegate`.