zfs

zfs is a skill for Claude Code from jmagar/claude-homelab. It costs 136 tokens per session (3,572 once invoked), scanned B, original, MIT.

A set of procedures for managing ZFS storage pools in a homelab, meaning a personal server or networked home lab. ZFS is a filesystem and storage manager that can combine disks and protect data.

In plain words
What is it for?
It is for checking pools, managing snapshots, replicating datasets, tuning storage settings, checking capacity, scheduling scrubs, and troubleshooting ZFS problems.
Why use it?
It helps monitor storage health, keep recovery snapshots, replicate data between devices, and handle storage errors.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the homelab-core plugin — 18 skills, 5 commands, 1 agent shipped together

Good fit It is for checking pools, managing snapshots, replicating datasets, tuning storage settings, checking capacity, scheduling scrubs, and troubleshooting ZFS problems.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/jmagar/claude-homelab/zfs
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add jmagar/claude-homelab --skill zfs
Clone the repo
git clone --depth 1 https://github.com/jmagar/claude-homelab

Made for: Claude Code.

Or install homelab-core, the plugin that ships this one along with the rest of its 18 skills, 5 commands, 1 agent.

Its marketplace also offers this one on its own, as the plugin zfs/plugin install zfs after adding the marketplace above.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for zfs

README.md
[![agentmods](https://agentmods.dev/badge/skills/jmagar/claude-homelab/zfs/github.svg)](https://agentmods.dev/skills/jmagar/claude-homelab/zfs)
Your own site
<a href="https://agentmods.dev/skills/jmagar/claude-homelab/zfs"><img src="https://agentmods.dev/badge/skills/jmagar/claude-homelab/zfs/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for zfs

Your own site · 80×15
<a href="https://agentmods.dev/skills/jmagar/claude-homelab/zfs"><img src="https://agentmods.dev/badge/skills/jmagar/claude-homelab/zfs.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 136 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,572 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00136 $0.03572
Opus 5 $0.00068 $0.01786
Sonnet 5 $0.00027 $0.00714
Haiku 4.5 $0.00014 $0.00357

Measured 12d ago against content hash 2543dd4c239d, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade B, and why

zfs scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

The scan reads SKILL.md. This mod also ships 6 executable files (examples/basic-health-check.sh, examples/multi-device-replication.sh, examples/performance-tuning.sh, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

sudo sanoid --prune-snapshots --verbose
skills/zfs/SKILL.md · 407 lines

How it starts

The opening of the file, as written. The whole thing — 407 lines — stays where its author put it; the contents beside it link to each section on GitHub.

ZFS Homelab Management

⚠️ MANDATORY SKILL INVOCATION ⚠️

YOU MUST invoke this skill (NOT optional) when the user mentions ANY of these triggers:

  • "check ZFS pool health", "ZFS status", "pool health", "zpool status"
  • "setup ZFS replication", "configure replication", "sync ZFS datasets"
  • "configure ZFS snapshots", "setup Sanoid", "snapshot retention"
  • "optimize ZFS performance", "tune ZFS properties", "ZFS compression"
  • "troubleshoot ZFS", "ZFS errors", "failed replication", "degraded pool"
  • "schedule ZFS scrubs", "setup scrubbing", "monthly scrub"
  • "check pool capacity", "pool space", "ZFS disk usage"
  • Any mention of ZFS, Sanoid, Syncoid, zrepl, raidz1, or ZFS datasets

Failure to invoke this skill when triggers occur violates your operational requirements.

Purpose

Comprehensive ZFS management for homelab environments with multi-device replication, automated snapshot management, performance optimization, and health monitoring.

Read-Write Operations: This skill performs both monitoring (read-only) and management (read-write) operations including:

  • Pool health checks and monitoring
  • Snapshot creation and pruning
  • Dataset replication between devices
  • Property optimization
  • Scrub scheduling

Recommended Architecture: Pull-based replication from centralized backup server to 5 source devices.

Based on research: Synthesized from 130+ URLs, 56,000+ vector database entries, and official OpenZFS/Oracle/FreeBSD documentation.

🚨 DESTRUCTIVE OPERATIONS - CRITICAL SAFETY PROTOCOL

ABSOLUTE REQUIREMENT: NO DESTRUCTIVE COMMANDS WITHOUT EXPLICIT USER AUTHORIZATION AND DOUBLE CONFIRMATION

This section defines the MANDATORY safety protocol that MUST be followed for ALL destructive ZFS operations.

Destructive Command Categories

EXTREMELY DESTRUCTIVE (Permanent Data Loss):

  • zfs destroy - Permanently destroys datasets/snapshots (UNRECOVERABLE)
  • zfs destroy -R - Recursively destroys all snapshots and child datasets (CATASTROPHIC)
  • zpool destroy - Destroys entire pool and all data (CATASTROPHIC)
  • zfs rollback - Rolls back to snapshot, LOSING all intermediate changes (DATA LOSS)
  • zpool labelclear - Removes ZFS labels, makes data inaccessible (DATA LOSS)

Read the full file on GitHub · 407 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 407 lines · 136 tokens per session scan B 2543dd4c239d

Subscribe to this mod's changes

zfs is a skill published in the GitHub repository jmagar/claude-homelab (78 stars, last pushed 1mo ago), licensed MIT. It adds 136 tokens to every session and 3,572 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it B with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

mission-creation

Use this skill to create and drive a UAV mission end-to-end through the web UI with the Playwright MCP browser tools on LOCALDEV (https:// ) — rebuild/redeploy, Keycloak login, the multi-step BYROUTE/REALTIME mission wizard, pre-flight, the Start-Mission FSM, AND the full per-drone flight-command lifecycle (arm →…

atretyak1985/swarmery · 176 tokens

github-actions-cicd

Design, review, or debug GitHub Actions workflows — CI jobs (type-check, lint, test, build, security, summary), AWS ECR/ECS deploys, and a standardized per-repo workflow set. NOT for cloud-auth role/OIDC trust details (use aws-cicd-auth) or Dockerfile/image-build mechanics (use docker-build).

atretyak1985/swarmery · 78 tokens

jira-delivery

Close the needs-fix branch for both ticket classes: isolated git worktree, a red test BEFORE any implementation on change tickets, delegation to a core executor, every publish action (push / PR / comment / QA transition) gated behind a green @verification-agent verdict, commit + push + PR, then writeback via…

atretyak1985/swarmery · 114 tokens

jira-triage

Parse a Jira ticket past access preflight, classify it as a defect or a change, run the mandatory evidence step that class demands (reproduction / baseline + absence proof), and assign exactly one of five verdicts (already-fixed / cannot-reproduce / needs-fix / needs-info / too-large). NOT for posting the verdict back…

atretyak1985/swarmery · 95 tokens

aws-cicd-auth

Configure and review AWS auth for GitHub Actions CI/CD — OIDC role assumption, ECR push perms, ECS deploy perms, least-privilege IAM. Not for application IAM/Cognito, not for GCP.

atretyak1985/swarmery · 50 tokens

deployment

Use this skill for a Helm-upgrade deploy of an app service (the web portal or the edge service) to an EXISTING Kubernetes cluster, plus post-deploy verification. NOT for cluster-level ops -- Minikube/k3s lifecycle, GCP firewall, tunnels, bootstrap secrets (use kubernetes-deployment); NOT for cross-environment…

atretyak1985/swarmery · 79 tokens