processkiller

Files (1)

• SKILL.md

SKILL.md (first lines)

---
name: processkiller
description: >
  Identify and terminate processes by port number, process name, or PID.
  Cross-platform (Windows, macOS, Linux). Use when the user asks to kill
  a process by port, name, or PID, or mentions port conflicts, occupied
  ports, stuck processes, or wants to free up a port. Also triggers on
  phrases like "kill process", "占用端口", "结束进程", "释放端口",
  "force close", "terminate process".
license: MIT
---

# ProcessKiller

Identify the process occupying a given port, or find a process by name or PID,
then ask the user for confirmation before terminating it.

## Workflow

```
User provides input
        │
        ▼
┌──────────────────────┐
│ Step 1: Identify     │ ← Determine input type: port, process name, or PID
│         input type   │
└──────────────────────┘
        │
        ▼
┌──────────────────────┐
│ Step 2: Find process │ ← Run OS-specific commands to locate the process
└──────────────────────┘
        │
        ▼
┌──────────────────────┐
│ Step 3: Show details │ ← Display process name, PID, port (if applicable)
└──────────────────────┘
        │
        ▼
┌──────────────────────┐
│ Step 4: AskUser      │ ← Ask user: "Kill this process?"
└──────────────────────┘
        │
     ┌──┴──┐
     ▼     ▼
   Yes    No
   kill  done
```

## Step 1: Identify Input Type

Determine what the user provided:

- **Port number**: A number between 1-65535 (e.g., `3000`, `8080`)
- **Process name**: A string that looks like an executable name (e.g., `node.exe`, `python`, `java`)
- **PID**: A positive integer, typically 4-6 digits (e.g., `1234`, `5678`)

If ambiguous (e.g., `8080` could be a port or a PID), default to treating it as a port number. If the user explicitly says "PID 8080" or "process 8080", use that context.

## Step 2: Find Process

### By Port Number

**Windows:**
```bash
netstat -ano | findstr /R "^[^:]*:[0-9]*:.*<PORT> "
```

Or using PowerShell:
```powershell
Get-NetTCPConnection -LocalPort <PORT> | Select-Object -ExpandProperty OwningProcess
```

**macOS / Linux:**
```bash
lsof -i :<PORT> -t 2>/dev/null
```
Or:
```bash
ss -tlnp "sport = :<PORT>" | grep -oP 'pid=\K[0-9]+'
```

### By Process Name

**Windows:**
```bash
tasklist /FI "IMAGENAME eq <NAME>" /FO CSV /NH
```
Or:
```bash
wmic process where "name='<NAME>'" get ProcessId,Name,CommandLine /format:list
```

**macOS / Linux:**
```bash
pgrep -a <NAME>
```
Or:
```bash
ps aux | grep -i <NAME> | grep -v grep
```

### By PID

**All platforms:**
```bash
# Windows
tasklist /FI "PID eq <PID>" /FO CSV /NH

# macOS / Linux
ps -p <PID> -o pid,comm,args
```

## Step 3: Display Results

Show the user a clear summary:

```
Found process(es):
┌──────┬──────────────┬─────────┬──────────────────────────────┐

From fangkunx/skills, MIT.

More from fangkunx/skills