online-file-system-fault-diagnosis

Collect Linux filesystem state data and logs to diagnose faults without direct repairs.

1|1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/linfordWu/owls --skill online-file-system-fault-diagnosis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: online-file-system-fault-diagnosis
Source: https://github.com/linfordWu/owls/tree/main/skills/online-file-system-fault-diagnosis
Command: npx skills add https://github.com/linfordWu/owls --skill online-file-system-fault-diagnosis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Linux filesystem issues can escalate due to space, inode exhaustion, IO latency, and critical file integrity problems. The skill collects system state data and logs to provide non-destructive diagnostics and actionable guidance.

Core Features & Use Cases

  • Non-destructive data collection: gathers disk usage, inode stats, IO metrics, kernel logs, and file health indicators for quick diagnosis.
  • Scenario-driven guidance: identifies faults related to disk space, inode exhaustion, IO delays, or permission/file integrity problems, and proposes safe remediation steps.
  • Real-world use: staff can describe an issue (e.g., "disk space low on /data") and receive a structured diagnostic report with recommended actions.

Quick Start

Describe the problem and system context, and I will run the diagnostic script to collect filesystem data and provide recommendations.

Frequently Asked Questions about online-file-system-fault-diagnosis

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

FAQPage Schema
How do I diagnose Linux filesystem issues without causing system damage?

To diagnose Linux filesystem issues safely, you can run a non-destructive data collection script that gathers disk usage, inode stats, IO metrics, and kernel logs to generate diagnostic recommendations without executing direct repair actions.

What causes inode exhaustion on a Linux host and how do I check it?

Inode exhaustion on a Linux host occurs when the maximum number of file system objects is reached. You can check inode exhaustion by collecting system state data and inode stats using standard CLI tools to identify if the filesystem has run out of allocation capacity.

Can I collect IO latency metrics and disk usage stats from containers and virtual environments?

Yes, you can collect IO latency metrics and disk usage stats from containers and virtual environments. The diagnostic scope covers Linux hosts, containers, and virtual environments by gathering usage stats and IO metrics using standard CLI tools.

How do I troubleshoot Linux disk space low errors using iostat and kernel logs?

To troubleshoot Linux disk space low errors, provide the system context and describe the issue to trigger a diagnostic script that gathers iostat metrics, disk usage, and kernel logs, delivering a structured diagnostic report with recommended actions.

Does this filesystem diagnostic tool automatically repair file integrity and permission problems?

No, this filesystem diagnostic tool does not automatically repair file integrity and permission problems. It explicitly avoids direct repair actions, focusing on collecting system state data and logs to provide non-destructive diagnostics and safe remediation steps.

What standard CLI tools are required to check Linux mount state and file health?

Checking Linux mount state and file health requires standard CLI tools to gather usage stats, inodes, IO metrics, and kernel logs, alongside the specific collect_filesystem_info.sh script to generate diagnostic recommendations.