Agent skill

Gtrace Path Analysis

by automateyournetwork in automateyournetwork/netclaw

Network path tracing and monitoring — traceroute with MPLS/ECMP/NAT detection, continuous MTR monitoring, and distributed GlobalPing probes from 500+ worldwide locations.

Apache-2.0Auto-check passedDevOps & Cloud

Install Gtrace Path Analysis

skills CLI
$ npx skills add automateyournetwork/netclaw --skill gtrace-path-analysis -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install automateyournetwork/netclaw gtrace-path-analysis --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/automateyournetwork/netclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/workspace/skills/gtrace-path-analysis .claude/skills/gtrace-path-analysis && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
gtrace-path-analysis
GitHub stars
676
Token cost
~1.4k tokens
SKILL.md length
534 words
Files
1
Skills in repo
120
Repo updated
First seen
Licence
Apache-2.0

At a glance

Network path tracing and monitoring — traceroute with MPLS/ECMP/NAT detection, continuous MTR monitoring, and distributed GlobalPing probes from 500+ worldwide locations.

  • Works in 3 steps: Traceroute → Continuous Monitoring with MTR → Global Perspective
  • Tracing the path to a destination
  • SKILL.md covers How to Call the gtrace MCP Tools, When to Use, Available Tools and Workflow: Path Troubleshooting, plus 6 more sections
  • Calls python3; needs GLOBALPING_API_KEY

What it does

Gtrace Path Analysis is an agent skill from automateyournetwork/netclaw. Network path tracing and monitoring — traceroute with MPLS/ECMP/NAT detection, continuous MTR monitoring, and distributed GlobalPing probes from 500+ worldwide locations. Use when tracing the path to a destination, diagnosing slow network routes, detecting MPLS or ECMP load balancing, running MTR for intermittent packet loss, or testing reachability from global vantage points. Works standalone from this host, no external platform required; if Cisco ThousandEyes agents are already deployed, prefer te-path-analysis…

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Cloud networking and Incident response. The repository describes itself as: An AI agent that claws through your network. The licence is Apache-2.0.

When your agent uses it

  • Tracing the path to a destination
  • Diagnosing slow network routes
  • ECMP load balancing
  • Running MTR for intermittent packet loss

Example prompts

  • “/gtrace-path-analysis”

Requirements

  • Python 3
  • A credential in GLOBALPING_API_KEY

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Traceroute
  2. Continuous Monitoring with MTR
  3. Global Perspective

What it can do on your machine

Read from SKILL.md and the folder at commit 95bb17e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GLOBALPING_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gtrace Path Analysis loads about 1.4k tokens when it runs. Until then it costs about 195 tokens; SKILL.md has 534 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~195
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from automateyournetwork/netclaw at commit 95bb17e, republished under its Apache-2.0 licence (© automateyournetwork). 534 words, ~1,360 tokens.

Download SKILL.mdSave it as .claude/skills/gtrace-path-analysis/SKILL.md (or your agent's skills folder).
name
gtrace-path-analysis
description
Network path tracing and monitoring — traceroute with MPLS/ECMP/NAT detection, continuous MTR monitoring, and distributed GlobalPing probes from 500+ worldwide locations. Use when tracing the path to a destination, diagnosing slow network routes, detecting MPLS or ECMP load balancing, running MTR for intermittent packet loss, or testing reachability from global vantage points. Works standalone from this host, no external platform required; if Cisco ThousandEyes agents are already deployed, prefer `te-path-analysis` for BGP route analysis and agent-based outage investigation. For public-probe-only checks with no local traceroute/MTR, `globalping-external-checks` has the critical guidance on interpreting GlobalPing's no-probe vs. unreachable responses.
license
Apache-2.0
user-invocable
true

Network Path Analysis with gtrace

How to Call the gtrace MCP Tools

bash
python3 $MCP_CALL "gtrace mcp" TOOL_NAME '{"param":"value"}'

When to Use

  • Trace the path between two endpoints and identify each hop (router, latency, loss)
  • Detect MPLS labels, ECMP load balancing, and NAT translation points along the path
  • Monitor a path continuously with MTR to identify intermittent packet loss or latency spikes
  • Run distributed traceroutes from 500+ GlobalPing probe locations worldwide to compare paths from different vantage points
  • Verify transit providers, peering, and routing policy by inspecting AS-level path data
  • Troubleshoot asymmetric routing, suboptimal paths, or blackholes

Available Tools

ToolPurposeRequirements
tracerouteAdvanced traceroute with MPLS, ECMP, and NAT detectioncap_net_raw
mtrContinuous MTR monitoring with packet loss and jitter statscap_net_raw
globalpingDistributed traceroute/ping from 500+ worldwide probe locationsInternet access (optional GLOBALPING_API_KEY)

Workflow: Path Troubleshooting

When asked "why is traffic slow to X?" or "trace the path to X":

Step 1: Traceroute

Run an advanced traceroute to see every hop, latency, and any MPLS/ECMP/NAT indicators.

bash
python3 $MCP_CALL "gtrace mcp" traceroute '{"target":"8.8.8.8"}'

For IPv6:

bash
python3 $MCP_CALL "gtrace mcp" traceroute '{"target":"2001:4860:4860::8888"}'
Step 2: Continuous Monitoring with MTR

If the traceroute shows packet loss or high latency at a specific hop, run MTR to monitor continuously and confirm the problem is persistent.

bash
python3 $MCP_CALL "gtrace mcp" mtr '{"target":"8.8.8.8","count":100}'
Step 3: Global Perspective

Compare paths from multiple worldwide locations to determine if the issue is local or global.

bash
python3 $MCP_CALL "gtrace mcp" globalping '{"target":"8.8.8.8","from":"US,EU,Asia"}'

Workflow: MPLS Path Verification

Verify MPLS label-switched paths and label stacks along the path:

bash
python3 $MCP_CALL "gtrace mcp" traceroute '{"target":"10.0.0.1"}'

Look for MPLS label information in the hop details. Useful for verifying traffic engineering and MPLS VPN paths.

Workflow: ECMP Load Balancing Verification

Detect if traffic is being load-balanced across multiple equal-cost paths:

bash
python3 $MCP_CALL "gtrace mcp" traceroute '{"target":"192.168.1.1"}'

ECMP detection reveals when multiple next-hops exist at a given TTL, indicating load balancing.

Tool Parameters

traceroute
  • target (required): IP address or hostname to trace
mtr
  • target (required): IP address or hostname to monitor
  • count (optional): Number of probe rounds to send
globalping
  • target (required): IP address or hostname to probe
  • from (optional): Comma-separated list of probe locations (countries, cities, regions, ASNs)
Show full SKILL.md (213 more words)Show less

Output Format

All tools return structured results including:

  • traceroute — hop number, IP, hostname, RTT per probe, MPLS labels, ECMP paths, NAT detection
  • mtr — hop number, loss%, sent/recv counts, best/avg/worst/stdev RTT
  • globalping — per-probe-location results with path data, useful for global path comparison

Important Rules

  • Traceroute and MTR require cap_net_raw capability on the gtrace binary (set during install)
  • GlobalPing uses the public GlobalPing API — set GLOBALPING_API_KEY for higher rate limits
  • Always start with a single traceroute before running continuous MTR
  • Use GlobalPing to differentiate local vs global path issues
  • Cross-reference hop IPs with asn_lookup and geo_lookup from gtrace-ip-enrichment skill for full context
  • Record all path analysis in GAIT

Failure Behavior

  • If a tool call fails with an authentication or connection error, check that GTRACE_MCP_BIN is set and valid before assuming a data or device problem.
  • On a tool error (timeout, unreachable host, malformed response), report the failure and its error message directly to the user rather than fabricating or guessing at results.
  • For a confirmed read-only call, check connectivity and retry once if appropriate. For any call that changes state or sends a message, a timeout does not prove the action failed: inspect current state or delivery status before retrying, preserve the required approval/change gates, and do not repeat an action whose outcome is unknown.

© automateyournetwork, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in workspace/skills/gtrace-path-analysis of automateyournetwork/netclaw.

Open the folder on GitHubat commit 95bb17e

Compare with similar skills

Gtrace Path Analysis next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Gtrace Path Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gtrace Path Analysis this skillautomateyournetwork/netclaw676—~1.4kAutomated safety check: PassApache-2.0
Performing Ssl Certificate Lifecycle Managementmukul975/Anthropic-Cybersecurity-Skills34k—~867Automated safety check: PassApache-2.0
Devops AgentLeoYeAI/openclaw-master-skills2.2k—~5.3kAutomated safety check: NotesMIT
Kubeshark KFL2 Filter Referencekubeshark/kubeshark12k—~3.6kAutomated safety check: PassApache-2.0
Nginx To Higress Migrationhigress-group/higress9.5k—~3.9kAutomated safety check: PassApache-2.0
Bfe Rd Workflowbfenetworks/bfe6.3k—~1.3kAutomated safety check: PassApache-2.0

Similar skills

  • Performing Ssl Certificate Lifecycle Management

    mukul975/Anthropic-Cybersecurity-Skills

    Automates the full SSL/TLS certificate lifecycle, including generating Certificate Signing Requests, issuing, deploying, monitoring, renewing, and revoking X.509 certificates, using Python and ACME…

    34k GitHub stars~867 tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed
  • Devops Agent

    LeoYeAI/openclaw-master-skills

    Your on-call DevOps assistant — one-click deploy, monitoring setup, scheduled backups, and fault diagnosis.

    2.2k GitHub stars~5.3k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check: notes
  • Syntax reference for KFL2, the CEL-based display filter language used to search Kubernetes network traffic captured by Kubeshark, loaded before any filter is written.

    12k GitHub stars~3.6k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Nginx To Higress Migration

    higress-group/higress

    Migrate from ingress-nginx to Higress in Kubernetes environments.

    9.5k GitHub stars~3.9k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Bfe Rd Workflow

    bfenetworks/bfe

    引导用户在 bfe 代码库中完成一次完整的功能研发流程,包括需求对齐、文档修改、代码实现、集成测试与回归验证. An agent skill from bfenetworks/bfe.

    6.3k GitHub stars~1.3k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Investigates past Kubernetes incidents from Kubeshark traffic snapshots: takes captures, dissects API calls, extracts PCAPs and compares traffic over time.

    12k GitHub stars~5.3k tokensUpdated yesterday
    DevOps & CloudAuto-check passed

More from automateyournetwork/netclaw

All 120 skills in this repo
  • EVE-NG Lab Topology Design

    automateyournetwork/netclaw

    Entry point for designing EVE-NG network labs: classifies the request, gathers missing requirements, proposes options and validates the resulting topology.

    676 GitHub stars~612 tokensUpdated 3 days ago
    Auto-check passed
  • ACI Policy Change Deployment

    automateyournetwork/netclaw

    Deploys Cisco ACI policy changes only behind an approved ServiceNow Change Request, capturing pre and post-change fault baselines and rolling back automatically on a fault delta.

    676 GitHub stars~4.2k tokensUpdated 3 days ago
    Auto-check passed
  • Cisco ACI Fabric Health Audit

    automateyournetwork/netclaw

    Runs a phased health audit of a Cisco ACI fabric through MCP tools: node status, links, tenant and policy review, faults and endpoint learning.

    676 GitHub stars~2.9k tokensUpdated 3 days ago
    Auto-check passed
  • Anta Validation

    automateyournetwork/netclaw

    Validate Arista EOS network state against ANTA's pre-built 208-test catalogue, with structured pass/fail verdicts.

    676 GitHub stars~1.2k tokensUpdated 3 days ago
    Auto-check passed
  • Arista Cvp

    automateyournetwork/netclaw

    Arista CloudVision Portal (CVP) automation via REST API — device inventory, events, connectivity monitoring, tag management (4 tools).

    676 GitHub stars~2.2k tokensUpdated 3 days ago
    Auto-check: notes
  • AWS Cloud Monitoring

    automateyournetwork/netclaw

    AWS CloudWatch monitoring — metrics, alarms, log queries, VPC flow log analysis, network performance.

    676 GitHub stars~1k tokensUpdated 3 days ago
    Auto-check passed

Categories

Questions about Gtrace Path Analysis

What does Gtrace Path Analysis do?

Network path tracing and monitoring — traceroute with MPLS/ECMP/NAT detection, continuous MTR monitoring, and distributed GlobalPing probes from 500+ worldwide locations. Gtrace Path Analysis is an agent skill from automateyournetwork/netclaw. Network path tracing and monitoring — traceroute with MPLS/ECMP/NAT detection, continuous MTR monitoring, and distributed GlobalPing probes from 500+ worldwide locations.

When should I use Gtrace Path Analysis?

Gtrace Path Analysis fits situations like: tracing the path to a destination; diagnosing slow network routes; ECMP load balancing; running MTR for intermittent packet loss.

How do I install Gtrace Path Analysis in Claude Code?

Run `npx skills add automateyournetwork/netclaw --skill gtrace-path-analysis -a claude-code`. Or copy the skill folder (workspace/skills/gtrace-path-analysis in automateyournetwork/netclaw) into .claude/skills/gtrace-path-analysis in your project. Claude Code loads it when a task matches its description.

How do I install Gtrace Path Analysis in Codex?

Run `npx skills add automateyournetwork/netclaw --skill gtrace-path-analysis -a codex`. Or copy the skill folder (workspace/skills/gtrace-path-analysis in automateyournetwork/netclaw) into .agents/skills/gtrace-path-analysis in your project. Codex loads it when a task matches its description.

Can I use Gtrace Path Analysis in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add automateyournetwork/netclaw --skill gtrace-path-analysis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gtrace-path-analysis, .gemini/skills/gtrace-path-analysis, .github/skills/gtrace-path-analysis and .opencode/skills/gtrace-path-analysis in your project.

What does Gtrace Path Analysis need to run?

Going by SKILL.md and its folder, Gtrace Path Analysis needs the command-line tools its instructions call (python3) and credentials named GLOBALPING_API_KEY. Our summary lists: Python 3; A credential in GLOBALPING_API_KEY.

Does Gtrace Path Analysis access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Gtrace Path Analysis safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Gtrace Path Analysis use?

Gtrace Path Analysis is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gtrace Path Analysis use?

About 1.4k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Gtrace Path Analysis?

Skills that share tags, products or a category with Gtrace Path Analysis: Performing Ssl Certificate Lifecycle Management (mukul975/Anthropic-Cybersecurity-Skills, 34k stars), Devops Agent (LeoYeAI/openclaw-master-skills, 2.2k stars), Kubeshark KFL2 Filter Reference (kubeshark/kubeshark, 12k stars) and Nginx To Higress Migration (higress-group/higress, 9.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gtrace Path Analysis?

automateyournetwork (a GitHub user) maintains it in automateyournetwork/netclaw, which has 676 GitHub stars. The repository holds 120 skills in this directory. The repository was last updated on October 5, 2026.

Source: automateyournetwork/netclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.