hermeticormus/linux-sysadmin-skills · Archived

sysadmin-diagnose

Diagnose a failing service or system issue on a Debian/Ubuntu Linux machine with a hypothesis-driven loop that gathers evidence from journalctl and systemctl, finds patterns, tests a hypothesis, fixes, and verifies.

First seen Aug 3, 2026

Installation

$ npx skills add hermeticormus/linux-sysadmin-skills --skill sysadmin-diagnose

Summary

  • Diagnose a failing service or system issue on a Debian/Ubuntu Linux machine with a hypothesis-driven loop that gathers evidence from journalctl and systemctl, finds patterns, tests a hypothesis, fixes, and verifies.
  • Use when something is broken and you need root cause, not a guess.

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from hermeticormus/linux-sysadmin-skills.

npx skills add hermeticormus/linux-sysadmin-skills

Browse all from hermeticormus/linux-sysadmin-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 3
License LICENSE
Default branch main
Open issues 0
Status Archived

Skill metadata

Parsed from SKILL.md frontmatter.

LicenseMIT

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,466 B
  • docs SUMMARY.md 307 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 3 installs

SKILL.md

System diagnosis

A system issue is happening. Diagnose and fix it on a Debian/Ubuntu Linux machine using a systematic, hypothesis-driven loop. Gather evidence before changing anything; confirm before applying a fix.

Diagnostic steps

  1. Describe the problem: what is happening, and when did it start?
  2. Gather information:

- System logs: journalctl -xe - Specific service logs: systemctl status <service> and journalctl -u <service> -xe - Resource usage: top, htop, df -h - Network: ip addr, ping, ss -tlnp

  1. Identify patterns: is it consistent or intermittent?
  2. Check recent changes: what changed before the issue appeared?
  3. Research: look for known issues.
  4. Test hypotheses: verify the likely cause before acting.
  5. Implement the fix: apply the solution.
  6. Verify: confirm the issue is resolved (systemctl is-active <service>, reproduce the original symptom).

Be systematic and thorough. Form a hypothesis from the evidence rather than guessing, and document findings for future reference.


See full content at https://github.com/HermeticOrmus/linux-sysadmin-skills.