agentsclimarketplace
Sign in

Octopusgarage heat guard

Skill OctopusGarage/octopusgarage-skills/skills/octopusgarage-heat-guard

Operate and diagnose macOS system health — auto-clean leaked agent shells + zombies, snapshot CPU/memory/disk pressure, and surface anomalies for notify-and-confirm termination. Use when the machine is hot/slow, to check what's hogging CPU/memory/disk, or as a periodic guardian tick.From its SKILL.md

Install
npx -y skills add OctopusGarage/octopusgarage-skills --skill octopusgarage-heat-guard

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.5 KB, 542 tokens by cl100k_base, as published. Nobody here has run it

octopusgarage-heat-guard

A macOS system-health guardian. Each invocation is one tick: run the deterministic script (which already auto-cleaned safe junk), then YOU (the AI) review the remaining candidates, and notify-and-confirm before terminating anything ambiguous. How this skill is scheduled is the operator's concern.

Setup

cd "$SKILL_DIR/scripts" && uv sync --quiet

Tick workflow

  1. Run the scan (auto-clean happens inside; it only kills zombies + leaked shells): 
    uv run python -m heat_guard.cli scan
    Use --dry-run to observe without killing.
  2. Read the JSON. If candidates is empty and system_flags is empty → report "healthy" and stop. This is the cheap common path.
  3. For each candidate, judge expected vs anomalous using its command, cpu_time_s, etime_s, pcpu, rss_mb, tripped, and the decision state in ~/.heat-guard/state.json:
    • Known-good (a build/encode you recognize, an agent session the user already acknowledged, THIS session or sibling loop/bot sessions) → skip.
    • Previously marked keep/snooze and still valid → skip.
    • Genuinely anomalous and unacknowledged → notify. If you need a candidate's working directory or owner to judge it (e.g. which project an agent session belongs to), fetch it on demand: lsof -a -p <pid> -d cwd and ps -o user= -p <pid>.
  4. Notify + confirm (never auto-kill): send the user a concise message — what, why it's suspicious, your recommendation — and ask them to confirm termination. Prefer the live Telegram channel (reply); if unavailable, use the fallback in heat_guard/telegram.py. Record the candidate as pending in ~/.heat-guard/state.json.
  5. On the user's reply: confirm → terminate (SIGTERM, then SIGKILL if it survives) and report; keep/snooze → record it so you stop nagging.

Hard rules

  • The script NEVER kills anything but zombies + leaked shells. You NEVER kill a candidate without explicit user confirmation.
  • Never touch this session or its ancestors (the script already protects them).
  • See references/triage-guidance.md for how to judge anomalies and message copy.

What ships with it: 18 files

23.1 KB alongside SKILL.md, 15 of them executable

agents/

references/

scripts/

Gives 0 of the 12 instructions most quality gates skills give in 542 tokens

Counted across 1,195 of the 2,094 authors here whose files we hold, read 2026-08-07

  • Read the output and check the exit codein 54 of 1195, across 14 files
  • Verify requirements using a line-by-line checklistin 53 of 1195, across 12 files
  • Identify the verification command proving the claimin 51 of 1195, across 12 files
  • Run the full verification commandin 50 of 1195, across 11 files
  • Verify output confirms the claimin 49 of 1195, across 12 files
  • Check version control diff after agent delegationin 46 of 1195, across 6 files
  • State claim with evidencein 44 of 1195, across 4 files
  • Run the test suitein 33 of 1195, across 26 files
  • Keep state in memory by defaultin 27 of 1195, across 6 files
  • Make prototype runnable with one commandin 26 of 1195, across 5 files
  • Produce a verification reportin 25 of 1195, across 14 files
  • Detect the package manager from lockfilesin 24 of 1195, across 5 files

Said here and by no other author read

  • report healthy and stop when empty
  • judge each candidate as expected or anomalous
  • skip known-good candidates
  • notify and confirm before termination
  • record candidates as pending
  • terminate on user confirmation

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.

Keep looking

Skills are one crate of 326,144. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.