# Queue Task

> Durable queue-task helper for resumable, idempotent batch jobs in task-father task folders.

- Skill: `modbender/queue-task` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add modbender/queue-task`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/queue-task/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/queue-task

---


# queue-task

Use this skill for durable long-running queue jobs with resumable batches.

Layout (task-father only):

- `<WORKSPACE_DIR>/<TASKS_DIR>/<slug>/...`

State files:
- `queue.jsonl`
- `progress.json`
- `done.jsonl`
- `failed.jsonl`
- `lock.json`

## Prerequisites

- `python3 --version`
- `openclaw status`
- `openclaw cron --help`

## Configuration (portable)

Skill-local config:

- Example: `config.env.example`
- Real machine config: `config.env`

Keys:

- `WORKSPACE_DIR`
- `TASKS_DIR`
- `BATCH_SIZE`
- `LOCK_STALE_MINUTES`
- `CRON_EXPR`
- `CRON_TZ`
- `DELIVERY_MODE`
- `AGENT_ID`

## Initialization / Installation / Onboarding

### Preferred (chat-first)

Provide:
1) task slug
2) batch size
3) lock stale minutes
4) schedule and timezone

Then initialize:

- `python3 scripts/queue_task.py init <slug>`

Smoke test:

- `python3 scripts/queue_task.py status <slug>`

### Optional (terminal)

- `cp config.env.example config.env`
- Edit `config.env`
- Run init/status commands above.

## Commands

- Init files:
  - `python3 scripts/queue_task.py init <slug>`
- Status:
  - `python3 scripts/queue_task.py status <slug>`
- Clear stale lock:
  - `python3 scripts/queue_task.py clear-stale-lock <slug>`
- Print worker template:
  - `python3 scripts/queue_task.py print-supervisor-template`

## Usage notes

- Prefer append-only JSONL logs.
- Process small batches.
- Update `progress.json` after each item.
- Keep idempotency keys task-defined.
- Use lock file to avoid concurrent runs.