← Back to Skills Marketplace
wang-junjian

Port Process

by 军舰 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
271
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install port-process
Description
通过端口查找和管理系统进程。支持查找占用端口的进程、杀掉占用端口的进程、查看端口使用情况等操作。适用于 macOS 和 Linux 系统。使用场景:(1) "谁占用了 8080 端口",(2) "杀掉占用 3000 端口的进程",(3) "查看当前端口使用情况"。
Usage Guidance
This skill appears to do exactly what it says: find/list ports and optionally kill the owning processes. Before using: (1) run with --dry-run or --json to inspect targets, (2) prefer --safe to send SIGTERM before SIGKILL, (3) avoid running kill commands as root unless you intend to, and (4) if you allow autonomous agent invocation, be aware an agent could execute the destructive kill operations — consider requiring explicit user confirmation before any termination.
Capability Analysis
Type: OpenClaw Skill Name: port-process Version: 1.0.0 The skill bundle provides tools for managing system processes by port but contains shell injection vulnerabilities in `scripts/find_port.py` and `scripts/list_ports.py`. These scripts use `subprocess.run(shell=True)` with f-strings to execute system commands like `lsof` and `ps`, which could be exploited if the port input is not strictly validated as an integer. While the provided CLI entry points use `argparse` to enforce integer types, the underlying functions are inherently risky. The capability to terminate arbitrary system processes is high-risk, although it appears consistent with the skill's stated purpose.
Capability Assessment
Purpose & Capability
Name/description match the provided scripts and SKILL.md. The scripts and example shell commands use lsof/ss/netstat/ps and OS signals to locate and terminate processes — exactly what a port-process management tool should do. No unrelated services, credentials, or external endpoints are required.
Instruction Scope
SKILL.md and bundled scripts limit actions to locating/listing ports and sending signals to PIDs. The kill script prompts for confirmation and offers --dry-run/--safe modes. Note: the skill performs destructive actions (kill signals); exercise care and use --dry-run/--safe before terminating processes. The scripts use subprocess.run(shell=True) but validate/parse ports as integers via argparse, limiting injection risk.
Install Mechanism
No install spec or external downloads — the skill is instruction-only with included Python scripts. Nothing is fetched from remote URLs or written by an installer.
Credentials
The skill requests no environment variables, credentials, or config paths. It may require elevated privileges (sudo) to see or kill other users' processes, which is expected and documented in SKILL.md.
Persistence & Privilege
always is false, there is no request for persistent/global agent changes, and the skill does not modify other skills or system-wide agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install port-process
  3. After installation, invoke the skill by name or use /port-process
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of port-process skill. - 查找、终止、管理系统端口对应的进程,支持 macOS 和 Linux - 提供多种命令行方法(lsof、netstat、ss)快速查找端口进程 - 内含脚本:kill_by_port.py、find_port.py、list_ports.py,便于自动化和拓展 - 支持安全终止、干跑(dry run)、详细输出、JSON 输出等多种模式 - 详细操作案例、平台兼容说明和常见问题解答 - 面向开发、调试、自动化脚本等多场景使用
Metadata
Slug port-process
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Port Process?

通过端口查找和管理系统进程。支持查找占用端口的进程、杀掉占用端口的进程、查看端口使用情况等操作。适用于 macOS 和 Linux 系统。使用场景:(1) "谁占用了 8080 端口",(2) "杀掉占用 3000 端口的进程",(3) "查看当前端口使用情况"。 It is an AI Agent Skill for Claude Code / OpenClaw, with 271 downloads so far.

How do I install Port Process?

Run "/install port-process" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Port Process free?

Yes, Port Process is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Port Process support?

Port Process is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Port Process?

It is built and maintained by 军舰 (@wang-junjian); the current version is v1.0.0.

💬 Comments