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
npx skills add sammcj/agentic-coding --skill deferred-task-execution -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/deferred-task-execution/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/deferred-task-execution/
1Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill deferred-task-execution -a codex2Manually: put the files in place
.agents/skills/deferred-task-execution/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill deferred-task-execution -a cursor2Manually: put the files in place
.cursor/skills/deferred-task-execution/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sammcj/agentic-coding Skills/deferred-task-execution/SKILL.md2Manually: put the files in place
.github/skills/deferred-task-execution/SKILL.md1Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill deferred-task-execution -a gemini-cli2Platform CLI
gemini skills install https://github.com/sammcj/agentic-coding --path Skills/deferred-task-executionManually: put the files in place
.devin/skills/deferred-task-execution/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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