agent-self-scheduling

agent-self-scheduling is a skill for Codex from humaisali/Awesome-AI-Skills. It costs 24 tokens per session (1,193 once invoked), scanned A, a copy of agent-self-scheduling, MIT.

A guide for scheduling recurring AI-agent work with cron, system services, hooks, or loops. Cron is a system scheduler whose usual minimum interval is one minute.

In plain words
What is it for?
Use it to schedule one-time agents, recurring checks, heartbeat tasks, and sub-minute loops while accounting for persistence, logging, and timing limits.
Why use it?
It helps choose a scheduler safely and avoids running an AI agent on an unsafe, overly frequent timer.

Skill for Codex

Written for Codex: runs codex exec. Also seen: mentions Claude Code; mentions Codex.

Good fit Use it to schedule one-time agents, recurring checks, heartbeat tasks, and sub-minute loops while accounting for persistence, logging, and timing limits.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/humaisali/awesome-ai-skills/agent-self-scheduling
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add humaisali/Awesome-AI-Skills --skill agent-self-scheduling
Clone the repo
git clone --depth 1 https://github.com/humaisali/Awesome-AI-Skills

Made for: Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for agent-self-scheduling

README.md
[![agentmods](https://agentmods.dev/badge/skills/humaisali/awesome-ai-skills/agent-self-scheduling/github.svg)](https://agentmods.dev/skills/humaisali/awesome-ai-skills/agent-self-scheduling)
Your own site
<a href="https://agentmods.dev/skills/humaisali/awesome-ai-skills/agent-self-scheduling"><img src="https://agentmods.dev/badge/skills/humaisali/awesome-ai-skills/agent-self-scheduling/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for agent-self-scheduling

Your own site · 80×15
<a href="https://agentmods.dev/skills/humaisali/awesome-ai-skills/agent-self-scheduling"><img src="https://agentmods.dev/badge/skills/humaisali/awesome-ai-skills/agent-self-scheduling.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 24 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,193 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 92% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00024 $0.01193
Opus 5 $0.00012 $0.00596
Sonnet 5 $0.00005 $0.00239
Haiku 4.5 $0.00002 $0.00119

Measured 12d ago against content hash c352bb6add9f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

agent-self-scheduling scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

92% identical to agent-self-scheduling — 33 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

AI-ML & Data Science Skills/Agents & LLMs/agent-self-scheduling/SKILL.md · 90 lines

How it starts

The opening of the file, as written. The whole thing — 90 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Agent Self-Scheduling

When to Use

  • Use when the user asks for recurring, scheduled, heartbeat, or looped agent work.
  • Use when you need to choose between cron, external schedulers, hooks, or built-in agent scheduling.

First question: does the agent have a built-in scheduler (Hermes → Camp B), or do you own the clock (everything else → Camp A)?

Universal floor: cron is 1 minute minimum (5-field expr, no seconds) — every camp. For sub-minute you MUST use a while ...; sleep N; done loop, a TS extension, or an event hook. Never put an LLM on a tight timer.

Camp A — one-shot agents, you own the clock

These run once and exit (amnesiac unless resumed). Schedule them externally.

claude -p "PROMPT" --output-format json --allowedTools "Read,Edit,Bash"  # Claude Code
codex exec --json "PROMPT"                                                # Codex
pi run "PROMPT"                                                           # Pi

Wrap in a clock:

# 1. cron (>= 1 min floor)
*/10 * * * * cd /path/to/project && pi run "check X and report" >> ~/agent.log 2>&1
# 2. systemd timer (Linux, survives reboot, better logging) — OnUnitActiveSec=10min
# 3. dumb loop (sub-minute, or no cron available)
while true; do pi run "check X"; sleep 30; done

Gotchas (each breaks unattended runs if ignored):

  • Permissions hang forever. Pass --allowedTools (Claude) or sandbox/auto-approve flags (Codex), or the run blocks on a prompt.
  • Use JSON output (--output-format json / --json) so the wrapper parses results deterministically.
  • Runs are amnesiac. Resume (codex exec resume --last) or persist state to a file the next run reads.

Pi has NO built-in scheduler/loop/heartbeat by design — external clock only (or a TS extension for agent-side timers).

cmux — orchestration only, NO scheduler

cmux has no timer/watch/cron. Three ways to loop it: orchestrator-driven (send → sleep → read-screen on your own clock), a dumb while-sleep wrapper, or — preferred — event-driven via cmux notify + OSC terminal hooks, which is cheaper and more responsive than polling. read-screen is non-interruptive, safe to poll.

Read the full file on GitHub · 90 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 90 lines · 24 tokens per session scan A c352bb6add9f

Subscribe to this mod's changes

agent-self-scheduling is a skill published in the GitHub repository humaisali/Awesome-AI-Skills (5 stars, last pushed 1mo ago), licensed MIT. It adds 24 tokens to every session and 1,193 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. It is 92% identical to agent-self-scheduling, differing in 33 lines, and is treated as a copy.