btrfs

Administer and troubleshoot Btrfs filesystems using btrfs-progs.

6|1|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/L3DigitalNet/Claude-Code-Plugins --skill btrfs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: btrfs
Source: https://github.com/L3DigitalNet/Claude-Code-Plugins/tree/main/plugins/linux-sysadmin/skills/btrfs
Command: npx skills add https://github.com/L3DigitalNet/Claude-Code-Plugins --skill btrfs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides comprehensive tools and guidance for managing the Btrfs filesystem, addressing common issues like disk space management, data integrity, and snapshotting.

Core Features & Use Cases

  • Filesystem Administration: Manage subvolumes, snapshots, and RAID configurations.
  • Data Integrity: Perform scrubs and balances to ensure data is consistent and healthy.
  • Troubleshooting: Diagnose and resolve common Btrfs errors like ENOSPC and device failures.
  • Use Case: You suspect your Btrfs filesystem is running out of space due to metadata issues. Use this Skill to analyze usage, rebalance chunks, and ensure smooth operation.

Quick Start

Analyze the current Btrfs filesystem usage on the root mount point.

Frequently Asked Questions about btrfs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Btrfs metadata ENOSPC errors when my filesystem runs out of space?

To resolve Btrfs metadata ENOSPC errors, analyze the filesystem usage to identify chunk allocation issues, then rebalance the chunks to restore metadata space and ensure smooth operation.

What is the best way to manage Btrfs subvolumes and snapshots for backups?

Managing Btrfs subvolumes and snapshots involves creating nested subvolumes for data isolation and taking snapshots to capture filesystem states, enabling efficient backup strategies and rapid system rollbacks.

How do I perform a Btrfs scrub to check data integrity and fix RAID parity issues?

Performing a Btrfs scrub checks data integrity by scanning the filesystem for checksum errors and repairing them using RAID parity, ensuring data remains consistent and healthy across all configured devices.

Do I need btrfs-progs to troubleshoot device failures and manage RAID configurations?

Yes, you need the btrfs-progs package installed to perform any Btrfs filesystem operations, including troubleshooting device failures, managing RAID profiles, configuring quotas, and applying compression.

Why does Btrfs snapshot accumulation cause disk space problems and how do I clear it?

Btrfs snapshot accumulation causes disk space problems because deleted files remain allocated within existing snapshots; identifying and deleting accumulated snapshots releases the retained data chunks and frees up space.