ssh-incident
Skill534 starsChanged 17 days agoMITView on GitHub
A diagnosis order for "the server is down", "the site is slow", "something broke". Use when investigating a problem on a remote server through the ssh_* tools, before changing anything.
In this repository4 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- ssh-managerSkill
- ssh-operationsSkill
- ssh-restrictedSkill
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 33
Only now consider changing something.
- Distinctive: line 49
Do not restart a service before reading its logs.
- Distinctive: line 50
Do not clear a log file to free disk space without looking at it first.
- Distinctive: line 52
Do not run a fix on every server in a group because it worked on one.
- Distinctive: line 54
Do not report "fixed" when you restarted something and the symptom went away.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Diagnosing before touching
The instinct under pressure is to restart something. Resist it for four calls: a restart that fixes the symptom destroys the evidence, and you will be back tomorrow.
The order, and why it is this order
1. ssh_health_check — one call, and it answers most incidents outright.
A full disk, memory exhaustion and a load spike all look like "the site is down"
from outside. Start here every time.
2. ssh_service_status on the services that matter — the web server, the
database, the app. "Active" with a recent start time means something restarted
it; that is a clue, not a resolution.
3. ssh_tail on the relevant log, with follow: false so you get the last
lines back rather than a stream. The error is usually in there, in plain text,
and reading it takes ten seconds. Guessing takes an hour.
4. ssh_process_manager to list processes when the health check pointed at
CPU or memory. Find what is eating the machine before deciding what to do about
it.
Only now consider changing something.
Things that are true more often than they should be
- A full disk presents as everything being broken. Logs cannot be written,
databases refuse writes, uploads fail. Check
diskin the health output first, and look at/var/logbefore blaming the application. - "It worked yesterday" usually means something rotated, filled, or expired. A log that stopped rotating, a certificate, a token, a disk crossing 100%.
- A service that is running is not a service that is working.
active (running)and a port nobody answers on are entirely compatible. - Check whether it is only you. A network path, a DNS entry or a firewall rule can make one machine look dead from where you are and fine from elsewhere.
What not to do
- Do not restart a service before reading its logs. You lose the reason.
- Do not clear a log file to free disk space without looking at it first; move it aside if you must, and let the service reopen its handle.
- Do not run a fix on every server in a group because it worked on one. Confirm the same symptom is there first.
- Do not report "fixed" when you restarted something and the symptom went away. Say what you found and what you did — if you did not find a cause, say that too.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

