agentleFS
Ben-Lau1Ben-Lau1/codex-skills/skills/park-long-waits/SKILL.md

park-long-waits

Skill0 starsChanged 3 months agoMITView on GitHub

Park and resume work automatically when an external experiment, training run, deployment, build, download, queue job, review, remote process, or other operation leaves no useful action until it produces a result. Use proactively during long-running goals, when the user asks Codex to babysit or monitor slow work, or when repeated polling would waste agent turns. Keep active Goal mode active, checkpoint state, attach a completion-aware waiter or condition-triggered monitor, remain quiet while the operation is unchanged, wake the same task only when a result is actionable, and then continue the goal. Do not use merely because the overall task is long, while productive work remains, or for deterministic work that can continue now.

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 1

    1. Ben-Lau1/park-long-waits★ 0100% same

    Edited · 0

    None found.

    Wrote their own version · 0

    None found.

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository4 other files it gives its agents.

The file

Show its rules and text

We split this skill into the rules it gives an agent

27 rules. About 0 are common, 25 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈25

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use an event-based or session wait when an active tool, process, or subagent can wake the task on completion without repeated model turns.

    line 15
  2. Distinctive:

    Never replace deterministic work with waiting, and never launch a background process only to simulate sleep.

    line 18
  3. Very specific:

    Do not use shell sleep, frequent polls, repeated status commentary, or repeated no-change goal turns as a wake mechanism.

    line 20
  4. Distinctive:

    Do not pause, complete, or block an active Goal merely because its next useful action depends on an external result.

    line 24
  5. Distinctive:

    After registering and verifying the waiter, yield without changing Goal status.

    line 30
  6. Very specific:

    Never ask the user to pause Goal mode as part of this workflow.

    line 32
  7. Distinctive:

    Prefer mechanisms in this order:

    line 36
  8. Distinctive:

    Create a condition-triggered background monitor that probes the stable job identifier and wakes this same task only for a predeclared …

    line 39
  9. Distinctive:

    If condition-triggered wakeup is unavailable, create a one-time follow-up at the earliest credible completion time.

    line 40
  10. Distinctive:

    If neither a completion-aware wait nor a scheduling/thread-wakeup tool is available, write the checkpoint and clearly state that autonomous …

    line 41
  11. Distinctive:

    Keep the follow-up in the current chat so it inherits task context.

    line 43
  12. Distinctive:

    Put this checkpoint in the scheduled prompt or other durable task state.

    line 58
  13. Distinctive:

    When a credible completion estimate exists and there is no actionable intermediate milestone, schedule at or just after that estimate.

    line 63
  14. Distinctive:

    Prefer event completion over time estimates when an observable signal exists.

    line 64
  15. Distinctive:

    When completion time is uncertain, choose an interval proportional to the expected remaining time and never check more often than hourly …

    line 65
  16. Distinctive:

    Stop after three unchanged unattended checks unless the user asked for persistent monitoring.

    line 67
  17. Distinctive:

    Use read-only checks by default.

    line 68
  18. Distinctive:

    Treat creating the follow-up as part of an explicitly requested babysit, monitor, finish, or long-running workflow.

    line 69
  19. Distinctive:

    After the waiter or monitor is registered, verify its identity, target task, probe, and trigger conditions.

    line 71
  20. Distinctive:

    Read the checkpoint and recheck live state before reasoning from it.

    line 77
  21. Distinctive:

    If complete, cancel or disable the follow-up, continue the authorized workflow, and verify the final outcome.

    line 78
  22. Distinctive:

    If still running, update the evidence and schedule the next backed-off check.

    line 79
  23. Distinctive:

    If failed, diagnose only within the user's scope.

    line 80
  24. Distinctive:

    If the state is ambiguous, report the ambiguity instead of assuming success.

    line 81
  25. Distinctive:

    If retry limits are reached, stop the monitor and provide a concise status with the exact next manual check.

    line 82
  26. Distinctive:

    Never emit a wakeup-only message with no state check.

    line 84
  27. Distinctive:

    Use this compact shape when the scheduling tool needs a prompt:

    line 88

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Park Long Waits

Reduce idle agent turns by separating productive work from elapsed wall-clock time. Use native wait, Scheduled, reminder, monitor, or thread-wakeup tools to resume; a skill cannot wake itself.

Decide Whether to Park

Evaluate the next meaningful action, not the total task duration.

  1. Continue immediately when useful analysis, implementation, validation, documentation, or authorized parallel work remains.
  2. Use an event-based or session wait when an active tool, process, or subagent can wake the task on completion without repeated model turns.
  3. Park when no useful action is available and the earliest meaningful check is at least 60 minutes away.
  4. Park earlier only when the user explicitly requests it or a native follow-up is clearly cheaper than keeping an active session.
  5. Never replace deterministic work with waiting, and never launch a background process only to simulate sleep.

Do not use shell sleep, frequent polls, repeated status commentary, or repeated no-change goal turns as a wake mechanism.

Keep Active Goals Active

Do not pause, complete, or block an active Goal merely because its next useful action depends on an external result. Parking is a wait state inside the goal, not a Goal status transition.

  1. Checkpoint the goal and the external operation.
  2. Register one completion-aware waiter or condition-triggered monitor tied to the stable operation identifier.
  3. Configure the waiter to keep checking without waking the agent while the observed state is unchanged.
  4. Wake the same task only when the operation completes, fails, becomes ambiguous, or otherwise reaches a predeclared actionable state.
  5. After registering and verifying the waiter, yield without changing Goal status. On wake, revalidate live state and continue the existing Goal.

Never ask the user to pause Goal mode as part of this workflow. Never use complete or blocked as a substitute for waiting.

Choose the Resume Mechanism

Prefer mechanisms in this order:

  1. Attach a native completion-aware wait primitive to an already-running process, job, or subagent. Prefer event-driven commands such as a provider's wait/watch operation over timer polling.
  2. Create a condition-triggered background monitor that probes the stable job identifier and wakes this same task only for a predeclared actionable result. Keep unchanged checks silent and apply backoff inside the monitor.
  3. If condition-triggered wakeup is unavailable, create a one-time follow-up at the earliest credible completion time. Recheck live state on wake and reschedule with backoff when it is still running.
  4. If neither a completion-aware wait nor a scheduling/thread-wakeup tool is available, write the checkpoint and clearly state that autonomous resumption is unavailable in this environment. Do not ask the user to pause the Goal and do not claim the task will wake itself.

Keep the follow-up in the current chat so it inherits task context. Reuse or update an equivalent existing schedule instead of creating duplicates. Keep the computer and app requirements of local scheduled work in mind.

Checkpoint Before Yielding

Record enough state for a cold resume:

  • objective and verifiable definition of done
  • last confirmed state, evidence, and observation time
  • operation identity, such as job ID, process/session ID, URL, branch, artifact, or log path
  • exact read-only probe to run after waking
  • success, still-running, failure, and needs-input conditions
  • absolute next-check time with timezone
  • retry count, maximum retries, and backoff rule
  • authorized next action and any permission boundary that still applies

Put this checkpoint in the scheduled prompt or other durable task state. Do not rely on an informal ETA alone.

Schedule Conservatively

  • Schedule the earliest time when a new observation could change the next action.
  • When a credible completion estimate exists and there is no actionable intermediate milestone, schedule at or just after that estimate. Do not insert hourly checks only to watch progress.
  • Prefer event completion over time estimates when an observable signal exists.
  • When completion time is uncertain, choose an interval proportional to the expected remaining time and never check more often than hourly unless the user requests it. Use one hour only as the fallback minimum, not as a required first check.
  • Back off after unchanged checks by doubling the previous interval, capped at 4 hours unless the task justifies a longer checkpoint.
  • Stop after three unchanged unattended checks unless the user asked for persistent monitoring.
  • Use read-only checks by default. Do not broaden permissions or task scope for an unattended run.
  • Treat creating the follow-up as part of an explicitly requested babysit, monitor, finish, or long-running workflow. Otherwise avoid creating unrelated future work.

After the waiter or monitor is registered, verify its identity, target task, probe, and trigger conditions; then yield and stop agent-side polling. Leave any active Goal active. Do not mark a goal complete or blocked merely to silence it.

Resume Safely

On each wakeup:

  1. Read the checkpoint and recheck live state before reasoning from it.
  2. If complete, cancel or disable the follow-up, continue the authorized workflow, and verify the final outcome.
  3. If still running, update the evidence and schedule the next backed-off check.
  4. If failed, diagnose only within the user's scope; continue with an already-authorized recovery or request input.
  5. If the state is ambiguous, report the ambiguity instead of assuming success.
  6. If retry limits are reached, stop the monitor and provide a concise status with the exact next manual check.

Never emit a wakeup-only message with no state check. Never leave a recurring monitor active after completion.

Durable Follow-Up Prompt

Use this compact shape when the scheduling tool needs a prompt:

Resume the current task from this checkpoint.
Objective: <outcome and done criteria>
Last evidence: <state and timestamp>
Operation: <stable identifiers and locations>
Probe: <exact read-only check>
Decision: if complete, continue and verify; if running, update evidence and
back off; if failed or ambiguous, stop or ask according to the stated scope.
Schedule state: attempt <n>/<max>, next cadence <duration>.
Wake condition: <terminal or otherwise actionable states only>.
Keep unchanged checks silent. Do not expand permissions, duplicate schedules,
or report without checking.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.