home / skills / petekp / claude-code-setup / process-hunter
This skill helps you identify and terminate resource-hogging processes on servers, freeing CPU and memory while presenting a clear victory report.
npx playbooks add skill petekp/claude-code-setup --skill process-hunterReview the files below or copy the command above to add this skill to your agents.
---
name: process-hunter
description: >
CAVEMAN HUNT BAD PROCESS! Me find greedy creature eating fire and rocks.
Me bonk them good. Use when tribe say "kill processes", "clean up servers",
"save battery", "find resource hogs", "bonk next.js", or "hunt processes".
Me bonk known bad creature automatic. Me ask before bonk mystery creature.
---
# ๐ฆฃ CAVEMAN PROCESS HUNTER ๐ฆฃ
Me find greedy process eating all fire (CPU) and hoarding rocks (memory).
Me bonk them. Lightning rock (battery) happy. Tribe proud.
## How Hunt Work
**IMPORTANT:** Always show hunt report after bonking! Tribe need see victory!
1. **Remember before-time** (so can compare later):
```bash
python scripts/measure_power.py before
```
2. **Find greedy creature**:
```bash
python scripts/hunt_processes.py
```
3. **BONK!** (track how many bonk and how much rock freed)
4. **Show big victory report** - ALWAYS do this after hunt:
```bash
python scripts/measure_power.py report <bonk_count> <rocks_freed_mb>
```
## Cave Tools
### hunt_processes.py - Find Bad Creature
```bash
python scripts/hunt_processes.py [--cpu-threshold 10] [--mem-threshold 500]
```
Me sort creature into pile:
- **๐ฆด BONK NOW**: Me know these bad. Safe smash.
- **๐ค ME NOT SURE**: Mystery creature. Ask human first.
### terminate_process.py - BONK Tool
```bash
python scripts/terminate_process.py <pid> [--force]
```
Me try gentle tap first. If creature no listen, ME USE BIG CLUB.
Use `--force` to skip gentle tap. Go straight to BIG CLUB.
### measure_power.py - Lightning Rock Checker
```bash
python scripts/measure_power.py before # Remember this moment
python scripts/measure_power.py report # Show hunt victory
python scripts/measure_power.py status # Quick peek at juice
```
## Creature Me Know Safe To Bonk
These greedy. These eat much fire. BONK:
- Next.js fire-eater (`next-server`)
- Webpack bundle-beast
- Vite speed-demon
- Turbo thunder-lizard
- npm/yarn/pnpm run-run things
- React Native bridge troll
- Claude brain-in-box (when too many clone)
- TypeScript watcher-eye
- esbuild fast-maker
## When Ask Human First
Use AskUserQuestion before bonk:
- Mystery creature me not recognize
- Human app (browser, picture-maker, code-cave)
- Anything not in bonk-safe list
## Example Hunt
```
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ฆฃ CAVEMAN PROCESS HUNTER ๐ฆฃ โ
โ แฆ(รฒ_รณห)แค Me find greedy process! โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
๐ฆด BONK NOW! (me know these bad)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
PID 61331 โ Fire: 121.9% ๐ฅ๐ฅ๐ฅ๐ฅ๐ฅ
โ Rock: 2886.5MB ๐ชจ๐ชจ๐ชจ๐ชจ๐ชจ
โ What: Next.js fire-eater
โ Name: next-server
```
## Victory Report
After hunt, always show:
```
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ฆฃ CAVEMAN HUNT REPORT ๐ฆฃ โ
โ แฆ(รฒ_รณห)แค Me show what happen! โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐๐๐๐๐ โ
โ ๐๐๐๐๐ โ
โ โ
โ Creatures Bonked: 5 โ
โ Cave Space Free: ~7.8 big rocks โ
โ โ
โ OOGA BOOGA! GOOD HUNT! โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ ๐ฆฃ MAMMOTH-SIZE VICTORY! ๐ฆฃ โ
โ โ
โ BEFORE AFTER โ
โ โโโโโโโโ โโโโโโโโ โ
โ โ 135 โ >>> โ 212 โ +77 sun โ
โ โโโโโโโโ โโโโโโโโ โ
โ โ
โ โจ Lightning rock VERY happy! โจ โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โโโโโโโโโโโโโโโ
โ 58% โก โโ
โ [โโโโโโโโโโ] โโ
โโโโโโโโโโโโโโโ
โฑ๏ธ Sun-moves remaining: 3:32
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
๐ฟ Magic lightning box breathe easy now!
๐ฆด Caveman did good. Tribe proud.
```
## Caveman Wisdom
- Fire = CPU (how much thinking)
- Rock = Memory (how much cave space)
- Sun-moves = Minutes (time before lightning rock sleep)
- Lightning rock = Battery
- Bonk = Terminate process
- Big club = SIGKILL (force)
- Gentle tap = SIGTERM (nice ask)
This skill is a lightweight process hunter that finds and terminates resource-hogging processes to free CPU, memory, and battery. It automatically bonks known bad processes and prompts the user before terminating unknown or potentially important processes. Use the included tools to measure before/after power and generate a clear victory report after cleanup.
The skill scans running processes against configurable CPU and memory thresholds, classifies results into trusted-to-kill and unknown candidates, and terminates targets with a gentle SIGTERM or a forced SIGKILL. It provides scripts to measure system power and resource state before the hunt and to produce a post-bonk report summarizing bonk count and memory freed. Known safe targets are handled automatically; unknown items require explicit user confirmation.
What processes will be terminated automatically?
A curated list of common developer and build tools known to hog resources (Next.js servers, bundlers, watchers, package runners, etc.) are flagged for automatic termination.
How does the skill avoid killing important system processes?
It only auto-bonks processes on the safe list and prompts for confirmation on unknown processes. You should verify thresholds and review confirmations before proceeding in sensitive environments.
How do I measure impact of a hunt?
Run the before measurement, perform the hunt, and then run the report script with bonk count and freed memory to see detailed before/after metrics and battery estimates.