Skip to content
cccskills
FreePublished on GitHub

job-supervision

Launches and supervises long-running commands — solves, workflows, downloads, builds — detached with a log, PID and exit sentinel, then tells stuck from slow and kills verifiably. Use before running anything that may exceed a minute, for nohup or background launches, and when a run hangs, shows no output, or timed out.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Job supervision

The gate — answer before launching

  1. Success artifact: which file or remote state proves success? Poll that, not the client process.
  2. Birth signal: what shows the run alive by ~30 s — CPU accruing, a log or lock file created, a socket open? Not stdout: healthy jobs are often pipe-buffered silent.
  3. Progress: what emits progress, at what cadence, against known phase durations? If unknown, measuring them is this run's job.
  4. Silence budget: after how long without progress is it failed? An armed timer, not a vibe. On any exit, verify the artifact — silence is not success.

Preflight every fallible precondition before the expensive phase: credentials that expire, connectivity, config validation (snakemake -n), disk space.

Launch recipe

  • Detach from the tool's timeout in its own process group, keep the PID and the exit status: a background tool call is capped, and a plain nohup … & shares the tool shell's group. Launch as nohup perl -MPOSIX -e 'POSIX::setsid(); exec @ARGV' bash -c '<cmd>; echo "EXIT $?"' </dev/null >> <logdir>/<name>.log 2>&1 & echo $! > <logdir>/<name>.pid, then, after a second, confirm ps -o pgid= -p $(cat <name>.pid) prints the PID.
  • Never pipe a long-runner through tail/head. Log to a file, read the tail on demand.
  • Arm the watcher at once on the log, filtering for progress and every terminal state: Traceback|Error|Exiting|EXIT|Killed.
  • Verify downloads by size or checksum before relying on them.

Stuck vs. slow

Check: process alive (pgrep -f); CPU time accruing (ps -o time -p <pid>, two samples 20 s apart — not %CPU); the tool's own artifacts growing (fresh mtimes); lsof -p <pid> — a lone TCP connection in CLOSE_WAIT with flat CPU is a dead client. Flat on all → stuck. Then kill.

Verified kill

Kill the launched process group, not a command-line pattern: kill -- -$(cat <name>.pid), wait, pgrep -g $(cat <name>.pid) shows nothing; then remove stale locks (Snakemake: .snakemake/locks/) and relaunch. A kill is done when the process tree is confirmed gone.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Records hypotheses, evidence and decisions when proposing, selecting, running or evaluating forecast experiments, including backtests and feature or model comparisons. Excludes routine tests and unchanged forecast operation.

The English summary is being prepared. Showing the original description.

zoltanmaric/coppersushi69Updated Oct 20, 2026

gh

Free

Diagnose GitHub CLI hiccups caused by Codex sandbox constraints; not a general GitHub workflow.

The English summary is being prepared. Showing the original description.

zoltanmaric/coppersushi69Updated Oct 20, 2026

Review a design artifact (spec, plan, PR packet) with fresh, memoryless subagents. Invoke when the user asks — "goldfish this", "fresh eyes", "tear this apart" — or after suggesting it for a spec that has grown load-bearing and the user agrees.

The English summary is being prepared. Showing the original description.

zoltanmaric/coppersushi69Updated Oct 20, 2026

grill

Free

Interrogate the user before implementing a non-trivial or ambiguous ask, converging on shared intent. Use when the user says "grill me", when an ask admits multiple interpretations, or before any sizable piece of work whose intent isn't fully clear.

The English summary is being prepared. Showing the original description.

zoltanmaric/coppersushi69Updated Oct 20, 2026

Build and maintain a persistent, LLM-maintained markdown wiki following Andrej Karpathy's LLM Wiki pattern — the agent incrementally compiles raw sources into an interlinked knowledge base instead of re-deriving answers from scratch. Use this whenever the user wants to ingest a source (an article, paper, transcript, chapter, meeting notes), file knowledge or conversation findings into the wiki, query the accumulated knowledge base, lint or health-check the wiki, or mentions "the wiki", "knowledge base", "ingest this", "file this", "what do we know about X", or accumulating notes on a topic over time — even if they don't say "LLM Wiki" explicitly.

The English summary is being prepared. Showing the original description.

zoltanmaric/coppersushi69Updated Oct 20, 2026

Guides writing and editing Mermaid diagrams in GitHub-rendered Markdown so they remain readable across themes and preserve placeholder labels.

The English summary is being prepared. Showing the original description.

zoltanmaric/coppersushi69Updated Oct 20, 2026

See all skills by zoltanmaric

Report a problem with this skill