ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

Perf Tools

Trace Linux system performance bottlenecks in real time. Use when scanning disk I/O, monitoring latency, reporting CPU usage, alerting on memory leaks.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/ckchzh/perf-tools
Or

Perf Tools

Sysops toolkit v2.0.0 — scan, monitor, report, and manage system performance from the command line.

Commands

All commands follow the pattern: perf-tools <command> [input]

When called without input, each command displays its recent entries. When called with input, it records a new timestamped entry.

CommandDescription
scanRecord or view scan entries
monitorRecord or view monitor entries
reportRecord or view report entries
alertRecord or view alert entries
topRecord or view top process entries
usageRecord or view usage entries
checkRecord or view check entries
fixRecord or view fix entries
cleanupRecord or view cleanup entries
backupRecord or view backup entries
restoreRecord or view restore entries
logRecord or view log entries
benchmarkRecord or view benchmark entries
compareRecord or view compare entries
statsSummary statistics across all log files
export <fmt>Export all data (json, csv, or txt)
search <term>Search across all log entries
recentShow the 20 most recent activity log entries
statusHealth check — version, entry count, disk usage
helpShow help with all available commands
versionPrint version string

How It Works

Each domain command (scan, monitor, report, etc.) works in two modes:

  • Read mode (no arguments): displays the last 20 entries from its log file
  • Write mode (with arguments): appends a timestamped YYYY-MM-DD HH:MM|<input> line to its log file and logs the action to history.log

The built-in utility commands (stats, export, search, recent, status) aggregate data across all log files for reporting and analysis.

Data Storage

All data is stored locally in ~/.local/share/perf-tools/:

  • Each command writes to its own log file (e.g., scan.log, monitor.log, alert.log)
  • history.log records all write operations with timestamps
  • Export files are saved as export.json, export.csv, or export.txt
  • No external network calls — everything stays on disk

Requirements

  • Bash 4+ with set -euo pipefail
  • Standard Unix utilities: date, wc, du, grep, tail, sed, cat
  • No external dependencies or package installations needed

When to Use

Metadata

Author@ckchzh
Stars3562
Views1
Updated2026-03-29
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-ckchzh-perf-tools": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.