Pilot Network Map

Visualize network topology, trust graphs, and latency. Use this skill when: 1. Generating network topology diagrams or adjacency matrices 2. Visualizing trus...

Security Scan

The skill's requirements and runtime instructions are coherent with its stated purpose (network topology and latency visualization), but the SKILL.md references additional tooling and network probing behavior that are not declared and merit attention.

Purpose & Capability

Name/description match the instructions: the skill runs pilotctl to enumerate peers, trust edges, connections, and measure latency — exactly what a network topology/latency visualizer would need. It correctly requires the pilotctl binary and a running Pilot Protocol daemon.

Instruction Scope

The SKILL.md instructs the agent to run pilotctl commands, produce DOT for Graphviz, and use jq to parse JSON. It also includes a ping operation that will actively probe nodes for latency. These actions are consistent with the stated purpose, but the doc omits explicit mention of the jq and Graphviz (dot) tools and does not warn that pinging can generate network traffic or probe remote nodes.

Install Mechanism

Instruction-only skill (no install spec, no files written to disk). This is low risk and consistent with the manifest.

Credentials

No environment variables, credentials, or config paths are requested. The skill does not ask for unrelated secrets or access, which is proportionate to its function.

Persistence & Privilege

always:false and default invocation settings are used. The skill does not request persistent or elevated platform privileges and does not modify other skills' configurations.

Assessment

This skill appears to do what it claims: it queries the Pilot Protocol via pilotctl and formats results for Graphviz. Before installing, confirm you have a trusted pilotctl binary and that running the daemon and pilotctl commands is acceptable in your environment. Note the SKILL.md implicitly requires jq and Graphviz's dot (they are not listed in the manifest) and the ping command will actively probe nodes (may generate network traffic or reveal topology). If you do not want network probes or parsing tools available to the agent, do not enable this skill or restrict its runtime environment. If you need higher assurance, ask the author for an explicit list of required binaries and a description of what pilotctl's ping/trust endpoints do.

Visualize network topology, trust graphs, and latency maps for Pilot Protocol.

Commands

List all peers (nodes)

pilotctl --json peers

List trust relationships (edges)

pilotctl --json trust

Ping for latency (edge weights)

pilotctl --json ping <node-id>

List active connections

pilotctl --json connections

Workflow Example

Generate DOT format for Graphviz:

#!/bin/bash
echo "digraph pilot_network {"
echo "  rankdir=LR;"

# Add nodes
pilotctl --json peers | jq -r '.peers[] | "  \"\(.node_id)\" [label=\"\(.hostname)\"];"'

# Add trust edges
pilotctl --json trust | jq -r '.trusted[] | "  \"\(.source)\" -> \"\(.target)\";"'

echo "}"

Render with: dot -Tpng network.dot -o network.png

Dependencies

Requires pilot-protocol skill and a running daemon.