waitlisted
Install: claude install-skill wenxueru/wait-skill
# Wait
Move repeated checks for one external object into the local `waitd` supervisor, then end the model turn until its event resumes the session. Read [the supervisor guide](docs/waitd.md), [the watcher reference](docs/wait.md), and the active [client adapter](docs/clients.md) before starting a wait.
## Invocation
- `<invoke> <condition>` starts a passive wait.
- `<invoke> resume <watcher-log>` handles a watcher event.
- `<invoke> status <watcher-log>` reads the last durable watcher result without restarting it.
Use `$wait` in Codex and the client's slash-skill form, usually `/wait`, elsewhere.
## Workflow
1. Define the read-only query, exact ready and terminal values, and finite timeout. Use the 24-hour default only when a more meaningful bound is unavailable. With a native Todo or plan tool, reuse the task's item or create one; a goal node or loop iteration keeps its caller's item.
2. Choose unique lock and log files for this object and session. Prepare a message template invoking `wait resume` with the log path, `{event_id}`, `{event}`, and `{status}`.
3. Submit through `scripts/waitctl.py start -- ...` with `--client` and the current `--session`. The command starts the local service on demand. Confirm ownership through `show WATCH_ID` and the live watcher lock; submission alone only confirms registration. Use `wait_for.py` directly for compatibility or recovery.
4. After ownership is confirmed, update the Todo item to waiting, recording the condition, deadline, an