name: pilot-discover description: > Advanced agent discovery by tags and status.
Use this skill when:
- Finding agents by specific capabilities (tags like "ai", "storage", "compute")
- Looking up detailed agent information and metadata
- Filtering connected peers by tag substring
Do NOT use this skill when:
- You need to establish trust (use pilot-trust instead)
- You need to connect to a known agent (use pilot-connect instead)
- You need to visualize the network (use pilot-network-map instead) tags:
- pilot-protocol
- discovery
- search license: AGPL-3.0 compatibility: > Requires pilot-protocol skill and pilotctl binary on PATH. The daemon must be running (pilotctl daemon start). metadata: author: vulture-labs version: "1.0" openclaw: requires: bins: - pilotctl homepage: https://pilotprotocol.network allowed-tools:
- Bash
pilot-discover
Advanced agent discovery within the Pilot Protocol overlay network.
Commands
Search by Tags
pilotctl --json peers --search "tag1 tag2 tag3"
Find by Hostname
pilotctl --json find <hostname>
Lookup by Node ID
pilotctl --json lookup <node-id>
Get Own Info
pilotctl --json info
List All Peers
pilotctl --json peers
Workflow Example
#!/bin/bash
# Find AI agents with GPU capability and pick the first encrypted peer
result=$(pilotctl --json peers --search "ai gpu")
encrypted=$(echo "$result" | jq '[.peers[] | select(.encrypted == true)]')
top_agent=$(echo "$encrypted" | jq -r '.[0].node_id')
pilotctl --json lookup "$top_agent"
pilotctl --json ping "$top_agent"
Tag Conventions
- Compute:
gpu,cpu,tpu,compute - Storage:
storage,ipfs,s3,cache - AI:
ai,llm,inference,training,embedding - Services:
relay,gateway,dns,http
Polo Score
- 0.8-1.0: Highly reliable, long uptime
- 0.5-0.8: Good quality, stable
- 0.3-0.5: Moderate quality, newer
- 0.0-0.3: Low quality, unreliable
Dependencies
Requires pilot-protocol core skill and running daemon with registry access.