Agent skill · research science · affaan-m
network-bgp-diagnostics
Diagnostics-only BGP troubleshooting patterns for neighbor state, route exchange, prefix policy, AS path inspection, and safe evidence collection. Use when a BGP neighbor is down, routes are missing, or prefix policy and AS path need inspection.
Why this skill is useful
Provides specific BGP troubleshooting patterns and commands that the AI may not reliably generate on its own.
What it needs
About 3k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
Network BGP Diagnostics Use this skill when a BGP session is down, flapping, established with missing routes, or advertising unexpected prefixes. The default workflow is read-only evidence collection; policy and reset actions belong in a reviewed change window. When to Use BGP neighbors are stuck in Idle, Connect, Active, OpenSent, or OpenConfirm. A session is Established but expected prefixes are missing. A route-map, prefix-list, max-prefix limit, or AS path policy may be filtering routes. You need before/after evidence for a BGP change. You are reviewing automation that parses BGP summary output. Read-Only Triage Flow 1. Identify the exact neighbor, address family, VRF, and local/remote ASNs. 2. Capture summary state and last reset reason. 3. Prove reachability to the peer source address. 4. Check route policy references before assuming transport failure. 5. Compare advertised, received, and installed routes where the platform supports those commands. Use platform-specific address-family commands when the device uses VRFs, IPv6, VPNv4, or EVPN. Do not assume global IPv4 unicast. State Interpretation State First checks --- --- Established with prefix count Route exchange is up; inspect policy and table selection Established with zero prefixes Check inbound policy, max-prefix, advertised routes, and AFI/SAFI Active TCP session is not completing; check routing, source, ACLs, and peer reachability Connect TCP connection is in progress; check path and remote listener OpenSent/OpenConfirm TCP works; check ASN, authentication, timers, capabilities, and logs Idle Neighbor may be disabled, missing config, blocked by policy, or backoff timer Transport Checks If the peer is sourced from a loopback, confirm both directions route to the loopback addresses and that the neighbor config uses the expected update source. Avoid disabling ACLs or firewall policy as a diagnostic shortcut. Read hit counters, logs, and path state first. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/network-bgp-diagnostics--88bc9c