Skip to main content
skill CX Codex

deferred-task-execution — Claude Code skill: setup and features

deferred-task-execution delays command execution in Claude Code for a specific duration or until a chosen time. Handy when builds or scripts need to wait.

Apache-2.0 ★ 173 updated 2026-10-24

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add sammcj/agentic-coding --skill deferred-task-execution -a claude-code
Open on GitHub

What deferred-task-execution does

The skill accepts relative durations like 30m or 2h30m, as well as clock times like 14:30 or 3pm. If a specified clock time has already passed today, it schedules the action for tomorrow.

It launches a background script at wait-until.sh using Bash with background execution enabled. Claude Code captures the task identifier to allow cancellation via TaskStop and waits for completion output before continuing.

The terminal session must stay open. Closing the agent kills the background timer, and the queued work will never execute. Timezone calculations rely on the USER_TZ variable inside the script, configured by default to Australia/Melbourne.

What it helps with

  • schedule a command after a relative delay
  • defer test runs or migrations to a specific hour
  • cancel an ongoing background wait before it fires
  • automatically push past-time tasks to the following day

Example prompts for the agent

  • Run npm test in 45m
  • Deploy the project at 22:30
  • Cancel the deferred wait task

How to install deferred-task-execution

1Skills CLI (Vercel)

npx skills add sammcj/agentic-coding --skill deferred-task-execution -a claude-code

2Manually: put the files in place

~/.claude/skills/deferred-task-execution/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/deferred-task-execution/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about deferred-task-execution

How to install deferred-task-execution in Claude Code?

Run npx skills add sammcj/agentic-coding --skill deferred-task-execution -a claude-code in your terminal.

What does deferred-task-execution do?

It runs a background timer script so your agent waits for a specific duration or hour before executing a task.

Will the scheduled task trigger if I close Claude Code?

No, the agent session has to remain active in your terminal, otherwise the timer process halts.

Source text

SKILL.md · Apache-2.0
---
name: deferred-task-execution
description: Delays execution of a task until a specified time or after a duration. Use when the user asks to run something later, in X minutes/hours, at a specific time, schedule a command, or defer work to a future point.
allowed-tools: [Bash, Read, TaskStop]
---

# Deferred Task Execution

Delays agent work until a user-specified time using a background timer script, then proceeds with the deferred task.

## Script Location

`~/.claude/skills/deferred-task-execution/scripts/wait-until.sh`

## Supported Input Formats

The script accepts one argument in either format:

**Duration** - relative delay from now:
- `30s`, `5m`, `1h`, `90m`, `2h30m`, `1h15m30s`

**Clock time** - specific time of day:
- `14:30`, `9:00`, `3pm`, `3:30pm`
- If the time has already passed today, it waits until that time tomorrow

## Workflow

### Step 1: Confirm the user's intent

Confirm what task to perform and when. Parse their natural language into a wait-until argument:

| User says | Argument |
|-----------|----------|
| "in 30 minutes" | `30m` |
| "in an hour" | `1h` |
| "in 2 and a half hours" | `2h30m` |
| "at 3pm" | `3pm` |
| "at 14:30" | `14:30` |
| "at half past 9" | `9:30am` |

The script self-handles timezone via the `USER_TZ` variable defined at the top of `wait-until.sh` (defaults to `Australia/Melbourne`). Clock-time arguments are interpreted in that zone regardless of host TZ. Don't ask the user about timezones unless they mention travelling.

Tell the user exactly what will happen and when the timer will fire. Ask them to confirm before starting.

### Step 2: Launch the timer in background

Run the wait script using Bash with `run_in_background: true`:

```
~/.claude/skills/deferred-task-execution/scripts/wait-until.sh <argument>
```

Note the task ID from the response -- you need it to cancel.

### Step 3: Wait for the timer

Background Bash notifies you when the script exits. Wait for that notification; don't poll.

### Step 4: Execute the deferred task

Once the output contains "Timer complete. Proceed with deferred task.", carry out whatever work the user requested.

## Important Notes

- The agent session must remain open for the timer to work. If the user closes the session, the deferred task will not execute. Warn the user about this.
- For very long waits (multiple hours), remind the user that the session needs to stay active.
- If the user asks to cancel, use `TaskStop` with the background task ID.
- Always tell the user the calculated wake time so they know when to expect the action.

© sammcj · Apache-2.0 · sammcj/agentic-coding

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set73

The whole set →
compact-prep compact-prep — a Claude slash command that tidies the work state before the context window fills up, then hands you prompts for compacting the session and resuming it. CX Codex +1 ★ 173repo stars subagent-delegation subagent-delegation guides Claude Code in scoping sub-tasks, assigning file ownership, and choosing between clean named sub-agents or session forks. CX Codex +1 ★ 173repo stars openspeccer openspeccer opens a read-only local dashboard for an OpenSpec repository and reports active changes, artifacts, and tasks. Useful when you need project status. CX Codex +1 ★ 173repo stars json-schema-lookup json-schema-lookup — a skill that points Claude at the SchemaStore catalog so it can validate config files and look up allowed options. CX Codex +1 ★ 173repo stars compression-editor compression-editor is a Claude Code subagent that shortens prose, instructions, skills, and docs without losing meaning. It skips source code and summarisation. CX Codex ★ 173repo stars explain Explains code, systems, and algorithms using terminal ASCII diagrams or standalone interactive HTML step-through pages. CX Codex +1 ★ 173repo stars openspec-bootstrap openspec-bootstrap sets up OpenSpec in a repository by preparing its schema and config. Use it for a first-time setup or edits to openspec/config.yaml. CX Codex +1 ★ 173repo stars self-review self-review — a skill that critically reviews your recent changes and fixes what it finds. Small edits it handles itself; larger ones go to a sub-agent. CX Codex +1 ★ 173repo stars

Project sponsors

Companies that keep this analytics open