Agent skill · magnus919
meshcore-packet-capture
Capture MeshCore Companion packets via BLE, serial, or TCP.
What it needs
About 6k tokens when loaded.
What this skill does
MeshCore Packet Capture Use this skill when operating, configuring, deploying, or troubleshooting meshcore-packet-capture, especially requests involving Companion radios, BLE/serial/TCP capture, MQTT publishing, LetsMesh, TOML configuration, Docker, systemd, launchd, or NixOS. Scope boundary This project captures from MeshCore Companion radios only. Do not route repeater or RoomServer capture here; use meshcoretomqtt instead. Operating workflow 1. Identify the transport before changing configuration: ble: direct address, device name, or general scan. serial: one or more serial ports; the runtime uses the first configured port. tcp: host and port, with SDK auto-reconnect enabled by default. 2. Prefer the installed CLI: For a checkout, use python3 -m meshcorepacketcapture or python3 packetcapture.py. Verified CLI boundary (v2.2.0): the parser exposes --output, --verbose, --debug, --no-mqtt, repeatable --config, and the neighbors on-demand pair --neighbors-now / --neighbors-exit (run one zero-hop neighbor discovery + scopes cycle immediately; with --neighbors-exit, quit when the cycle finishes). It does not expose --show-config or a dry-run flag. Run the exact installed binary with --help before documenting or using any other flag; do not invent a configuration-preview command. 3. Configure one IATA code and at least one MQTT broker before expecting network uploads. LOC is a placeholder, not a useful deployment identity. 4. Start with --no-mqtt when isolating radio connectivity. Add MQTT only after the device captures packets locally. 5. Verify the actual boundary after every change: device connection logs, packet output, broker connection, and service/container status. Do not treat a successful install as proof of a working capture. Mutation gate: when the request is read-only or plan-only, do not present stop/start/edit/delete/restart commands as actions to perform. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills magnus919/meshcore-packet-capture