← Back to Skills Marketplace
114
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install perf-prof
Description
Linux system performance analysis using perf-prof for real-time event processing and profiling CPU, memory, IO, scheduling, virtualization, and custom scripts.
Usage Guidance
This skill is a documentation-driven workflow for a low-level Linux profiler and is internally coherent with that purpose. Before using it, verify the upstream source (the SKILL.md references https://github.com/OpenCloudOS/perf-prof.git) and inspect the repository you will clone. Understand that most useful profiling commands require root: the skill instructs writing to /sys/kernel/debug/tracing, adding kprobes/uprobes, reading other processes' maps, and (in some workflows) reading kernel memory (/proc/kcore). These are powerful operations that can affect system behavior and expose sensitive memory. Also note the documented expression builtin system(...) can execute arbitrary shell commands if expressions are accepted from untrusted inputs — avoid feeding untrusted expressions or run profiling in an isolated/test environment. If you plan to proceed on production hosts: (1) review the GitHub source code and commits, (2) build from a verified release or checksum, (3) run initially on a non-production machine or in a VM/container, and (4) explicitly confirm any root actions with an administrator before executing them.
Capability Analysis
Type: OpenClaw Skill
Name: perf-prof
Version: 1.0.0
The skill bundle provides a comprehensive Linux performance analysis suite (perf-prof) that includes several high-risk capabilities. Most notably, the expression engine documented in 'references/expr.md' includes a 'system()' function for executing shell commands, and 'references/profilers/python.md' describes a profiler that executes arbitrary Python scripts for event processing. While the instructions in 'SKILL.md' are strictly focused on legitimate system diagnostics (CPU, IO, and memory analysis) and no explicit malicious payloads or exfiltration commands were found, the inclusion of a shell-execution helper within a performance tool's expression evaluator represents a significant security risk and a potential vector for exploitation.
Capability Assessment
Purpose & Capability
The name/description (perf-prof Linux performance analysis) matches the SKILL.md and the many profiler reference documents. There are no unrelated environment variables or surprising external services requested. One small metadata inconsistency: registry metadata lists Source: unknown / Homepage: none, while SKILL.md points to a GitHub repo (https://github.com/OpenCloudOS/perf-prof.git). The GitHub URL in the instructions aligns with the stated purpose, but the registry record not listing the source is a minor discrepancy to verify.
Instruction Scope
The instructions correctly cover installing (git clone, build) and running perf-prof and reference many operations expected for a low-level profiler: reading /proc, writing to /sys/kernel/debug/tracing (kprobe/uprobe events), adding probes, using perf-prof to sample events, and reading symbol maps. These actions inherently require elevated privileges and can modify kernel tracing state. The expression language documented (expr.md) exposes a built-in system(...) function which permits executing formatted shell commands from expressions — this is a powerful capability and, if combined with untrusted inputs, can execute arbitrary commands. All of these behaviours are consistent with the tool's purpose but are high-impact and must be run with caution and user consent.
Install Mechanism
This is an instruction-only skill (no automated install spec). The SKILL.md suggests cloning and building from a GitHub repo (https://github.com/OpenCloudOS/perf-prof.git) and installing system packages via yum. That is proportionate to compiling a system profiler, but the skill will instruct the user to fetch and run code from a remote repository and install OS packages—verify the repository and its integrity before building. There is no package checksum or release host verification provided.
Credentials
The skill requests no environment variables, which is expected. However, the runtime instructions routinely require root privileges (installing packages, writing to /sys/kernel/debug/tracing, reading /proc/kcore, adding kprobes/uprobes, and reading other processes' maps). Those privileges are appropriate for a system profiler but are sensitive. Additionally, the documented expression builtin system(...) allows executing shell commands from inside perf-prof expressions — this can run arbitrary commands if expressions come from untrusted sources. Treat these privilege needs as intentional but high-risk and verify you trust both the user inputs and the perf-prof binary/source before granting them.
Persistence & Privilege
The skill is not always-enabled, has no install-time persistence spec, and is instruction-only. It does not request system configuration changes beyond the actions the user would perform at runtime. The skill can be invoked autonomously by the agent by default (disable-model-invocation is false) which is platform normal; combine that with the high‑privilege operations above only if you trust the skill and the agent's autonomy.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install perf-prof - After installation, invoke the skill by name or use
/perf-prof - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of perf-prof skill
- Provides a comprehensive workflow to use perf-prof for Linux system performance diagnosis.
- Details installation, including dependency handling and user confirmation for source builds.
- Includes a full decision tree for selecting the right profiler based on system symptoms (CPU, memory, IO, virtualization, etc.).
- Categorizes and explains available profilers; links to documentation when available, and outlines core analysis techniques.
- Adds step-by-step instructions for both kernel-space and user-space diagnostics.
- Features both Chinese and English descriptions for broader accessibility.
Metadata
Frequently Asked Questions
What is Perf Profiler?
Linux system performance analysis using perf-prof for real-time event processing and profiling CPU, memory, IO, scheduling, virtualization, and custom scripts. It is an AI Agent Skill for Claude Code / OpenClaw, with 114 downloads so far.
How do I install Perf Profiler?
Run "/install perf-prof" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Perf Profiler free?
Yes, Perf Profiler is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Perf Profiler support?
Perf Profiler is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Perf Profiler?
It is built and maintained by duanery (@duanery); the current version is v1.0.0.
More Skills