arch-system-troubleshooter

Diagnose Arch Linux failures using local docs and Arch Wiki.

190|27|Updated Apr 22, 2026
One-click install
npx skills add https://github.com/linxuan-sys/opencode-skills-chinese --skill arch-system-troubleshooter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arch-system-troubleshooter
Source: https://github.com/linxuan-sys/opencode-skills-chinese/tree/main/arch-system-troubleshooter
Command: npx skills add https://github.com/linxuan-sys/opencode-skills-chinese --skill arch-system-troubleshooter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you diagnose and resolve Arch Linux system problems—especially those involving rolling updates, crashes, command failures, and niri configuration issues—by guiding you through collecting the right evidence and applying fixes in a strict order that prioritizes local documentation and official sources.

Core Features & Use Cases

  • Evidence-first troubleshooting: Prompts for the exact error text, what triggered it, and relevant logs so the next steps match your real failure mode.
  • Official-first resolution workflow: Uses a local system document first, then Arch Wiki official guidance, and only falls back to precise targeted联网搜索 when needed.
  • Environment-accurate commands: Ensures suggested commands match Arch Linux with niri (Wayland), kitty, and fish, while avoiding cross-distro instructions that commonly cause more breakage.
  • Practical recovery and safety notes: Clearly flags risks for system modifications (e.g., rolling back), including backup guidance before you change anything.

Quick Start

Provide the exact error message, what you ran right before it happened, and any relevant log snippet, and ask for an Arch+niri-specific fix that first checks the local LinXuan system document and then Arch Wiki.

Frequently Asked Questions about arch-system-troubleshooter

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

FAQPage Schema
How do I troubleshoot Arch Linux boot failures and system crashes?

Troubleshoot Arch Linux system failures by providing the exact error text, triggering command, and relevant system logs to receive actionable recovery steps that prioritize local documentation and Arch Wiki guidance.

Why does my niri Wayland configuration break after a rolling update?

Niri configuration breaks after rolling updates due to upstream changes. Diagnose the exact failure by collecting error logs and applying environment-accurate fixes for your Arch, niri, kitty, and fish setup.

What is the safest workflow to repair Arch Linux system issues without causing more breakage?

The safest repair workflow is official-first: consult local system documents, then Arch Wiki official guidance, and only fall back to precise targeted online search if local sources fail.

Can I use generic Linux troubleshooting commands for my Arch plus niri environment?

Generic Linux commands often cause breakage. You need environment-accurate commands specifically tailored for Arch Linux with niri Wayland, kitty, and fish to ensure safe system recovery.

What should I do before attempting to roll back Arch Linux packages or modify system configurations?

Before rolling back Arch Linux packages or modifying configurations, create backups and review clearly flagged safety risks to prevent further system instability during your recovery process.