network-troubleshooting SKILL.md skillA

network-troubleshooting from dandi41/ntnroute is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add dandi41/ntnroute/network-troubleshooting@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
dandi41/ntnroute
Path
skills/network-troubleshooting/SKILL.md
Versions recorded
9
Latest version
v1.0.0, committed Nov 6, 2026
First version recorded
Nov 2, 2026
Size
6,160 bytes
Repository stars
11
License
MIT

OSI-first network device diagnosis with vendor commands.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Network Troubleshooting

Network device diagnosis using the OSI layer principle. This skill is a **guided diagnostic procedure**, not an output parser: identify the device/platform, gather targeted read-only evidence, and adapt commands to the actual OS/version. Examples are starting points; verify syntax before use.

## When to Use

- A device in the `ntn` inventory is unreachable, slow, or behaving oddly.
- A user reports "no internet", "can't ping", "link down", "duplex errors".
- You need to read the real state before deciding on a configuration change.
- You need to distinguish: device down vs path down vs your own SSH session dying.

Not for: changing configuration (that is the `network-change-management` skill),
adding/removing devices (that is the `ntnroute` skill), or plain Linux servers.

## Core Principles

1. **OSI layers, don't skip.** L1 → L2 → L3 → L4 → L7. Prove the lower layer
   is healthy before moving up. Exception: a specific symptom (DNS timeout) may
   go straight to the relevant layer.
2. **Read-only first.** All diagnostic commands are read-only. No
   `configure`, `set`, or `remove` during diagnosis. Changes = the
   `network-change-management` skill.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add dandi41/ntnroute/network-troubleshooting@sha256:15b1a626d631179b

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_uwafiqs26vcl6w4x.svg)](https://markdownregistry.com/a/art_uwafiqs26vcl6w4x)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 9 versions of this file, between Nov 2, 2026 and Nov 6, 2026, more than one a day.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-11-06 aeff5d4 6,160 BA view · diff
v1.0.02026-11-04 48e02f2 7,001 BA view · diff
v1.0.02026-11-04 9063762 6,981 BA view · diff
v1.0.02026-11-04 62eccd5 6,982 BA view · diff
v1.0.02026-11-03 ad1e8ec 6,623 BA view · diff
v1.0.02026-11-03 51dc781 6,381 BA view · diff
v1.0.02026-11-03 53bbdd8 6,194 BA view · diff
v1.0.02026-11-02 d4e9d68 5,503 BA view · diff
v1.0.02026-11-02 af687dd 5,532 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6160 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

dandi41/ntnroute · 11 stars · license MIT · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_uwafiqs26vcl6w4x
GET https://markdownregistry.com/api/v1/resolve?ref=dandi41/ntnroute/network-troubleshooting
GET https://markdownregistry.com/api/v1/blob/15b1a626d631179bc3d8895c3a3dc142a1fa72743e441ebb0c91ff1a02ca75fe

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from dandi41/ntnroute

network-change-management SKILL.md skill
dandi41/ntnroute · skills/network-change-management/SKILL.md · Gate network changes: plan, approval, rollback, verify.
v1.1.0 · audit A · 11 stars
network-device-cli SKILL.md skill
dandi41/ntnroute · skills/network-device-cli/SKILL.md · Use when SSHing into a router, switch, or firewall CLI.
v1.1.0 · audit B · 11 stars
network-security-audit SKILL.md skill
dandi41/ntnroute · skills/network-security-audit/SKILL.md · Audit network device security: local hardening and perimeter.
v1.0.0 · audit A · 11 stars
ntnroute SKILL.md skill
dandi41/ntnroute · skills/ntnroute/SKILL.md · Manage NTnRoute network devices via `ntn` CLI.
v1.1.0 · audit A · 11 stars

Every file in dandi41/ntnroute

Other files named network-troubleshooting

network-troubleshooting SKILL.md skill
mindrally/skills · network-troubleshooting/SKILL.md · Systematic, safety-first diagnosis of developer network failures such as connection refused, DNS resolution errors, TLS…
git:20261008.7682ca7 · audit A · 301 stars

Browse by kind, by grade A, or by owner.