nas-disk-diagnostic

Diagnose NAS disk health over SSH and generate visual SMART reports.

1|Updated Sep 11, 2026
One-click install
npx skills add https://github.com/lldwb/lldwb-claude-skills --skill nas-disk-diagnostic-lldwb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nas-disk-diagnostic
Source: https://github.com/lldwb/lldwb-claude-skills/tree/main/skills/nas-disk-diagnostic
Command: npx skills add https://github.com/lldwb/lldwb-claude-skills --skill nas-disk-diagnostic-lldwb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires paramiko, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Diagnosing failing NAS disks requires manually SSHing into the device, running many smartctl and mdadm commands, and interpreting raw SMART attributes—a slow, error-prone process where a missed flag (like -d sat for expansion-card disks) produces misleading results. ## Core Features & Use Cases - Remote Read-Only Collection: Connects via SSH (paramiko) to Synology and similar NAS devices to gather filesystem usage, RAID array status (/proc/mdstat, mdadm --detail), block devices, controller info, and dmesg ATA/I/O errors. - Deep SMART Diagnostics: Reads full SMART attributes, error logs, and self-test logs with the critical -d sat flag for disks behind expansion cards (e.g., ASMedia ASM1166), avoiding false "no SMART capability" reports. - Repairability Assessment & Visual Report: Applies a decision tree over key SMART attributes (IDs 5, 187, 188, 197, 198, 199, 9) to judge whether a failed disk is recoverable, then renders a single-file HTML report with status cards, slot grid, log-scale SMART charts, and power-on-hours comparison. - Use Case: Your Synology RAID array shows degraded status. Run the skill to locate the failed physical disk, determine from SMART raw values whether it can be rescan-recovered or needs replacement, and deliver a shareable HTML report with tiered action recommendations. ## Quick Start Ask the assistant to diagnose the disks on your NAS at a given IP with your SSH credentials and produce a health report.

Frequently Asked Questions about nas-disk-diagnostic

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

FAQPage Schema
How do I diagnose a failed disk in a Synology NAS?

Connect over SSH and collect RAID status from /proc/mdstat and mdadm --detail, then read SMART attributes for each disk. The skill's script automates this in basic and smart phases, and the decision tree in the SMART reference judges whether the disk is recoverable or needs physical replacement.

Why does smartctl report no SMART capability on my NAS disk?

Disks connected through expansion cards such as the ASMedia ASM1166 require the -d sat flag, otherwise smartctl falsely reports the device lacks SMART capability. Run smartctl -d sat -a /dev/sataN to read the real SMART data.

Which SMART attributes indicate a failing hard drive?

The key indicators are Current_Pending_Sector (197), Offline_Uncorrectable (198), and Reallocated_Sector_Ct (5). Values of 197 or 198 above 1000 usually mean the disk is unrecoverable, while UDMA_CRC_Error_Count (199) typically indicates a cable problem rather than disk failure.

Can this skill rebuild or repair my RAID array automatically?

No. The skill is read-only by design and never modifies RAID configuration. The only write operation is an online SCSI rescan, which requires explicit user confirmation; re-adding disks or rebuilding arrays is left to the user after reviewing the assessment.

What dependencies are required to run the NAS diagnostic script?

The script requires Python 3 and the paramiko package, installed via pip install -r requirements.txt. The target NAS must have SSH enabled and the account must have sudo permission to read SMART and mdadm data.