← Back to Skills Marketplace
mightybyte

ZFS

by mightybyte · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
584
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install zfs
Description
ZFS filesystem administration, pool management, dataset configuration, snapshots, replication, encryption, performance tuning, and troubleshooting on OpenZFS...
Usage Guidance
This skill appears to be a legitimate ZFS administration guide and includes helpful reference docs and a health-check script. Before installing or running anything: 1) Inspect the bundled scripts and references locally (especially replication scripts) rather than running them as-is. 2) Understand that zfs/zpool/ssh must be installed and most commands require root; the skill metadata does not declare those prerequisites — ensure you have the right binaries and privileges. 3) The replication examples recommend generating SSH keys without a passphrase and placing them in /root/.ssh; prefer using a dedicated limited-privilege user, protect keys (use passphrases or agent-based unlocking), and apply zfs allow to limit what the replication user can do. 4) If you plan to enable cron jobs or autorun replication, review and harden key permissions, host access, and logging; test in a non-production environment first. 5) If you are not comfortable with system administration or creating root-level keys, get an administrator to review these recommendations before applying them.
Capability Analysis
Type: OpenClaw Skill Name: zfs Version: 1.0.0 The OpenClaw AgentSkills bundle for ZFS administration is benign. It provides comprehensive documentation and a diagnostic script (`scripts/zfs_health_check.sh`) for managing ZFS filesystems. The `SKILL.md` and reference documents offer detailed instructions and best practices, including warnings against risky configurations and advice on security (e.g., using `zfs allow` for least privilege). While ZFS administration involves powerful system commands, the skill's content is entirely focused on legitimate system management tasks, with no evidence of malicious intent such as data exfiltration, unauthorized access, or prompt injection attempts to subvert the agent's purpose. The use of passphrase-less SSH keys in an example replication script (`references/replication.md`) is a common operational practice for automation, not an indicator of malice, and is accompanied by advice on least privilege.
Capability Assessment
Purpose & Capability
The skill's files, references, and health-check script are appropriate for ZFS administration and replication. However, the skill declares no required binaries/config paths even though SKILL.md and scripts assume system binaries (zfs, zpool, ssh, zpool list, etc.) and system paths. The omission is an inconsistency (it should declare required system tools and note that root privileges are typically needed).
Instruction Scope
Instructions stay within ZFS administration scope (pool/dataset/snapshot/replication). However, replication guidance and the included replication example recommend generating SSH keys with no passphrase (ssh-keygen -N "") and copying them to remote hosts, and the provided replication script references /root/.ssh/zfsrepl_key and runs ssh commands that assume root-level keys and access. Those recommendations are security-sensitive (automation vs key protection) and could enable broad remote access if applied without hardening. The SKILL.md also suggests running included scripts (zfs_health_check.sh) which execute privileged zfs/zpool commands — expected for the purpose but potentially dangerous if run blindly.
Install Mechanism
No install spec; this is instruction-only plus a small helper script. Nothing is downloaded or installed automatically. Risk is limited to running the provided scripts/commands on the host, which requires user/admin consent.
Credentials
The skill requests no environment variables or external credentials, which is appropriate. But it references and assumes access to system paths (/root/.ssh, /etc/zfs/keys, /usr/local/bin, /etc/sanoid, /sbin/zpool, etc.) and root-level operations in docs and example scripts. Those assumptions are reasonable for ZFS administration but should have been declared as required config-paths/privileges in the metadata.
Persistence & Privilege
The skill does not request always:true, does not modify other skills, and does not include an install that persists code from external sources. It does recommend creating cron jobs and system-level cron/daemon entries in examples (sanoid, syncoid cron), which is normal for replication tooling but requires administrator approval.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install zfs
  3. After installation, invoke the skill by name or use /zfs
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the ZFS administration skill. - Provides detailed, best-practice guidance for ZFS pool creation, expansion, and management on Linux and macOS. - Includes dataset configuration, snapshot management, encryption setup, and recommended defaults. - Emphasizes never using file-backed pools in production; strong production/test safety warnings. - Covers performance tuning (recordsize, compression, ARC, SLOG, L2ARC), advanced vdevs, and workload recommendations. - Supplies health check procedures and references for troubleshooting, replication, and platform-specific considerations.
Metadata
Slug zfs
Version 1.0.0
License
All-time Installs 1
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is ZFS?

ZFS filesystem administration, pool management, dataset configuration, snapshots, replication, encryption, performance tuning, and troubleshooting on OpenZFS... It is an AI Agent Skill for Claude Code / OpenClaw, with 584 downloads so far.

How do I install ZFS?

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

Is ZFS free?

Yes, ZFS is completely free (open-source). You can download, install and use it at no cost.

Which platforms does ZFS support?

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

Who created ZFS?

It is built and maintained by mightybyte (@mightybyte); the current version is v1.0.0.

💬 Comments