process-hunter

Detect and terminate resource-hogging processes using CPU and memory thresholds.

5|2|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/petekp/agent-skills --skill process-hunter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: process-hunter
Source: https://github.com/petekp/agent-skills/tree/main/skills/process-hunter
Command: npx skills add https://github.com/petekp/agent-skills --skill process-hunter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps automatically identify resource-hogging processes on a host and safely terminate them to reclaim CPU and memory.

Core Features & Use Cases

  • Detects high-CPU and high-memory processes and classifies them into safe-to-bonk, uncertain, or ignore categories.
  • Provides a deterministic workflow using Python scripts: hunt_processes.py for discovery, measure_power.py for monitoring power, and terminate_process.py for graceful termination with a fallback to a hard kill.
  • Useful for development servers, CI runners, and production-like environments where rogue processes can throttle performance.

Quick Start

Run the caveman process-hunter script to identify greedy processes and bonk them safely.

Frequently Asked Questions about process-hunter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically terminate high CPU and memory processes on a server?

Automatically terminating high CPU and memory processes involves detecting resource-hogging targets, classifying them by safety, and sending SIGTERM or SIGKILL signals. This Skill handles discovery and graceful termination to reclaim host performance during builds or CI pipelines.

What is the best way to stop rogue processes throttling performance during software builds?

Stopping rogue processes during software builds requires monitoring CPU and memory thresholds to identify hogs, then safely terminating them. This Skill classifies targets into safe-to-bonk, uncertain, or ignore categories to prevent accidental critical system termination.

How do I identify and kill resource-hogging processes on local development machines?

Identifying and killing resource-hogging processes on local development machines uses a deterministic workflow to discover greedy targets and terminate them. It monitors resource consumption and applies configured rules to safely bonk processes throttling your dev environment.

Does this process termination method use graceful shutdowns or hard kills?

This process termination method uses graceful shutdowns by default with a fallback to hard kills. It issues a SIGTERM signal first, and if the resource-hogging process does not terminate, it escalates to a SIGKILL to reclaim CPU and memory.

Can I use automated process management for CI runners and dev servers?

Automated process management is highly effective for CI runners and dev servers. It continuously monitors host resources, detects when processes exceed configured CPU or memory thresholds, and safely terminates them to prevent performance throttling.

When should I avoid automatically terminating high CPU processes?

You should avoid automatically terminating high CPU processes when targets fall into the uncertain or ignore classification categories. The detection mechanism evaluates resource thresholds to ensure only safe-to-bonk processes are killed, preventing damage to critical system services.