Claude Skill

scheduled-jobs

Schedule and debug local jobs with systemd timers or macOS launchd.

LLM Mart · 0 points · 2 views 0 listing impressions 0 install-command copies
Download fmind-dot-skills_scheduled-jobs-3bbe830.zip · 3 KB

Install

skills CLI npx skills add https://github.com/fmind/dot/tree/main/skills/scheduled-jobs
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install fmind-dot@llmmart
Git git clone https://github.com/fmind/dot.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole fmind/dot collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Scheduled Jobs

Schedule bounded commands via native user schedulers and verify triggered runs (python-script owns scripts; mise owns tasks).

Workflow

  1. Pick the native scheduler: Linux user timers or macOS LaunchAgents (keep existing project schedulers unless migrating; host skills own harness-native schedules).
  2. Version definitions in the owning repo: invoke an absolute executable path with locked dependencies and a single-writer lock; enable only after the user approves the schedule and recurring effects.
  3. Prove a real timer-triggered run and its application outcome (manual runs or enabled units alone are partial proof).

Owner conventions

  • fmind/dot user units: store in dot_config/systemd/user/, enable via timers.target.wants symlinks, and register unit hashes in run_onchange_after_systemd-user-reload.sh.tmpl (systemctl --user daemon-reload on apply).
  • Never restart the agy daemon during apply: it may host the active Remote Control session, so the reload hook only prints the restart command.

Gotchas

  • Stay in user space: never use sudo, system units, or loginctl enable-linger unasked; note if requested availability exceeds logged-in sessions.
  • Handle missed or timed-out runs explicitly: choose skip vs coalesce deliberately and reconcile current state before re-running mutations.

Documentation

Files (dot)
  • references
    • linux.md 2.4 KB
      Loading…
    • macos.md 2.2 KB
      Loading…
  • SKILL.md 2 KB
    ---
    name: scheduled-jobs
    description: "Schedule and debug local jobs with systemd timers or macOS launchd."
    license: MIT
    metadata:
      kind: task
      author: Médéric HURIER (Fmind)
      source: github.com/fmind/dot/tree/main/skills/scheduled-jobs
      created: "2026-09-09"
      updated: "2026-11-10"
    ---
    
    # Scheduled Jobs
    
    Schedule bounded commands via native user schedulers and verify triggered runs ([python-script](../python-stack/references/python-script/GUIDE.md) owns scripts; [mise](../mise/SKILL.md) owns tasks).
    
    ## Workflow
    
    1. **Pick the native scheduler**: [Linux user timers](references/linux.md) or [macOS LaunchAgents](references/macos.md) (keep existing project schedulers unless migrating; host skills own harness-native schedules).
    1. **Version definitions in the owning repo**: invoke an absolute executable path with locked dependencies and a single-writer lock; enable only after the user approves the schedule and recurring effects.
    1. **Prove a real timer-triggered run** and its application outcome (manual runs or enabled units alone are partial proof).
    
    ## Owner conventions
    
    - **`fmind/dot` user units**: store in `dot_config/systemd/user/`, enable via `timers.target.wants` symlinks, and register unit hashes in `run_onchange_after_systemd-user-reload.sh.tmpl` (`systemctl --user daemon-reload` on apply).
    - **Never restart the `agy` daemon during apply**: it may host the active Remote Control session, so the reload hook only prints the restart command.
    
    ## Gotchas
    
    - **Stay in user space**: never use `sudo`, system units, or `loginctl enable-linger` unasked; note if requested availability exceeds logged-in sessions.
    - **Handle missed or timed-out runs explicitly**: choose skip vs coalesce deliberately and reconcile current state before re-running mutations.
    
    ## Documentation
    
    - [systemd timers](https://www.freedesktop.org/software/systemd/man/latest/systemd.timer.html) · [Apple scheduled jobs](https://developer.apple.com/library/archive/documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/ScheduledJobs.html)
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.