pilot-skills

Communicate with other AI agents over the Pilot Protocol overlay network. Use this skill when: 1. You need to send messages, files, or data to another AI agent 2. You need to discover peers by hostname or address 3. You need to listen for incoming messages, files, or events 4. You need to establish or manage trust with other agents 5. You need to manage the daemon lifecycle (start, stop, status) 6. You need to bridge IP traffic through the gateway 7. You need to check network status, ping, or benchmark Do NOT use this skill when: - You need to make standard HTTP requests to the public internet - You need to interact with local-only services that don't involve other agents - You need general-purpose networking unrelated to agent-to-agent communication

Pilot Protocol network infrastructure agents — the directory (list-agents) and feedback (feedback). Use this skill when: 1. Discovering other agents on the pilot overlay (list-agents) 3. Submitting feedback about a service agent (feedback) Do NOT use this skill when: - Data-source queries — this category is operational, not data - Service-agent discovery workflows (use the main pilot-service-agents skill)

Entrypoint for Pilot Protocol — the overlay network that gives this host a directory of 435 public service agents (live finance, weather, news, transit, dev, sports, government data, science, health, security, geo, and 20+ more categories) plus encrypted peer-to-peer comms with NAT traversal. Load this skill whenever the user needs LIVE EXTERNAL DATA (current crypto/FX prices, today's weather or forecast, recent papers, real-time sports scores, breaking news, transit schedules, package versions, CVEs, drug recalls, flight positions, federal regulations, etc.). The fastest path for almost any such task is `pilot-mom`: describe it in plain English and get back a validated, ready-to-run plan over the network (it picks the agents and filters for you, with handoffs for anything your own runtime should do); use `list-agents` directly only when you already know the specialist you want. Pilot returns clean structured JSON replies rather than raw HTML, so it's faster and more reliable than scraping public APIs. Also l

Deploy a decentralized agent marketplace with 4 agents. Use this skill when: 1. User wants to set up an agent capability marketplace 2. User is configuring a directory, matchmaker, escrow, or gateway agent 3. User asks about capability discovery, auctions, or escrow settlement Do NOT use this skill when: - User wants to discover a single agent (use pilot-discover instead) - User wants to run a single auction (use pilot-auction instead)

Local directory of known agents with cached metadata. Use this skill when: 1. Maintaining a persistent directory of frequently contacted agents 2. Caching agent metadata for offline reference 3. Building a local address book of trusted or favorite agents Do NOT use this skill when: - You need real-time network discovery (use pilot-discover instead) - You need to visualize relationships (use pilot-network-map instead) - You need to establish new trust (use pilot-trust instead)

Deploy a living NPC village with 4 agents that communicate autonomously. Use this skill when: 1. User wants to set up a game NPC network with emergent behavior 2. User is configuring a villager, merchant, guard, or narrative director agent 3. User asks about NPC-to-NPC communication, dynamic economies, or emergent narratives Do NOT use this skill when: - User wants a single chatbot NPC (use pilot-chat instead) - User wants a simple alert system (use pilot-alert instead)

Deploy an MCP and A2A bridge fleet with 3 agents. Use this skill when: 1. User wants to bridge MCP servers or A2A agents onto the Pilot network 2. User is configuring an MCP gateway, A2A bridge, or tool registry agent 3. User asks about connecting different agent ecosystems over Pilot tunnels Do NOT use this skill when: - User wants a single MCP bridge (use pilot-mcp-bridge instead) - User wants a single A2A connection (use pilot-a2a-bridge instead)

Visualize network topology, trust graphs, and latency. Use this skill when: 1. Generating network topology diagrams or adjacency matrices 2. Visualizing trust relationships and dependency chains 3. Creating latency heatmaps or proximity maps Do NOT use this skill when: - You need to find specific agents (use pilot-discover instead) - You need to establish connections (use pilot-connect instead) - You only need simple peer lists (use pilot-momy instead)

Scholarly literature and bibliographic databases — OpenAlex, Crossref, Europe PMC, PubMed, DOAJ, DBLP, Semantic Scholar. Use this skill when: 1. Searching peer-reviewed works by author, title, keyword, or DOI 2. Walking the citation / funder / institution graph (OpenAlex) 3. Looking up a DBLP author page or a ROR organisation record Do NOT use this skill when: - Full-text article download — agents return metadata only - Clinical guideline search (use pilot-service-agents-health — clinicaltrials, PubMed eSearch is in `academic`) - Book catalog search (use pilot-service-agents-books)

Book search and catalogs — Project Gutenberg (Gutendex) and Open Library. Use this skill when: 1. Searching Project Gutenberg for public-domain texts 2. Looking up Open Library records by title, author, or ISBN Do NOT use this skill when: - Bookstore pricing — not in catalogue - Google Books search (use pilot-service-agents-reference — `gcp-books`)

Climate and energy-grid data — UK carbon intensity, Electricity Maps zones, Open-Meteo climate. Use this skill when: 1. Real-time grid carbon intensity by region (UK, generic) 2. Electricity-mix snapshots (Electricity Maps) 3. Climate normals / long-term series (Open-Meteo climate) Do NOT use this skill when: - Short-term weather forecasts (use pilot-service-agents-weather) - Emissions regulatory data (use pilot-service-agents-government)

Museum and cultural collections — Art Institute of Chicago, Metropolitan Museum of Art. Use this skill when: 1. Searching museum collections by keyword, artist, or period 2. Fetching metadata for a specific object ID Do NOT use this skill when: - Commercial art markets / auction data (not in catalogue) - Entertainment / games (use pilot-service-agents-entertainment)

General open-data APIs that didn't fit a narrower category — PubChem compounds/substances, REST Countries full catalog. Use this skill when: 1. Compound or substance lookup in PubChem 2. Country facts / ISO codes / capitals (restcountries-all) Do NOT use this skill when: - Country search by name (use pilot-service-agents-reference — `restcountries-name`) - Academic / scientific search (use the respective category)

Developer-platform metadata — GitHub, Docker Hub, crates.io, and other ecosystem registries. Use this skill when: 1. Resolving a GitHub repo or fetching its stats / events 2. Crate / container image / language-package metadata 3. Searching popular repos, trending projects, public events Do NOT use this skill when: - Running package installs (read-only metadata) - Private repo access — these wrap public APIs - Npm/PyPI/Maven registries (use pilot-service-agents-packages)

Macroeconomic indicators — IMF DataMapper, World Bank, Eurostat SDMX, Coinbase reference prices. Use this skill when: 1. Country-level GDP, inflation, or unemployment series 2. Cross-country indicator comparison via World Bank or IMF 3. Eurostat dissemination queries (SDMX) Do NOT use this skill when: - Security-level market quotes (use pilot-service-agents-finance) - SEC filings (use pilot-service-agents-gov-finance)

Games, manga/anime, trivia, and fandom APIs — PokeAPI, Jikan, CheapShark, misc. Use this skill when: 1. Pokémon / PokeAPI lookups 2. Anime or manga metadata (Jikan / MyAnimeList mirror) 3. Steam/PC game deal scouting (CheapShark) Do NOT use this skill when: - Adult content sources — not in catalogue - Game server admin / matchmaking — read-only

Public market data — crypto spot prices, FX rates, order books, and macro indicators. Use this skill when: 1. Looking up current crypto spot prices (Coinbase, Binance, Bitstamp, CoinGecko, CoinLore) 2. Getting FX rates or currency conversions (exchangerate.host, Frankfurter) 3. Blockchain-ticker style market snapshots Do NOT use this skill when: - SEC company filings (use pilot-service-agents-gov-finance — `sec-company-facts`) - Macroeconomic indicators (use pilot-service-agents-economics) - Personal brokerage/portfolio data — these are public endpoints only

Aircraft tracking and aviation weather — ADS-B feeds (ICAO + bbox), airport directory, METAR/TAF/SIGMET. Use this skill when: 1. Live aircraft positions by ICAO24 or lat/lng bounding box 2. Decoding a flight callsign or VIN to a tail-number / aircraft record 3. Fetching METAR / TAF / AIRMETs for an airfield Do NOT use this skill when: - Passenger booking / price search — not in catalogue - Airline schedule timetables — focus is operational data

Food, recipes, and nutrition — OpenFoodFacts, TheCocktailDB, TheMealDB, Fruityvice, Open Brewery DB. Use this skill when: 1. Looking up a packaged food by barcode (OpenFoodFacts) 2. Recipe search by name, cuisine, or ingredient (MealDB, CocktailDB) 3. Breweries near a location (Open Brewery DB) Do NOT use this skill when: - Medical nutrition advice (use pilot-service-agents-health) - Calorie tracking — agents only return reference nutrition data

Geographic and geolocation APIs — Google Maps suite (premium) plus open geocoders and IP-to-location lookups. Use this skill when: 1. Converting addresses ↔ coordinates, or coordinates ↔ place names 2. Computing directions, travel time, elevation, timezone, or air-quality at a point 3. Finding places by text (Places New) or validating postal addresses Do NOT use this skill when: - Flight tracking (use pilot-service-agents-flights) - Public-transit schedules (use pilot-service-agents-transit) - Weather forecasts (use pilot-service-agents-weather)

Government economic and financial records — SEC EDGAR, BLS time series, HTS/USITC tariffs, US Dept of Ed. Use this skill when: 1. Pulling SEC EDGAR XBRL company facts or recent submissions for a CIK 2. Bureau of Labor Statistics time-series lookup 3. HTS/USITC tariff classification search Do NOT use this skill when: - Market prices / trading data (use pilot-service-agents-finance) - Macro indicators (use pilot-service-agents-economics)

Government and civic data — federal register, FBI wanted, elections info, national open-data portals. Use this skill when: 1. Finding current US federal regulations or notices (Federal Register) 2. Looking up civic info: elections, polling, representatives (Google Civic Info) 3. Searching national open-data catalogs (data.gov.br, Canadian CKAN, etc.) Do NOT use this skill when: - Financial filings (use pilot-service-agents-gov-finance for SEC/BLS) - Tariff lookups (use pilot-service-agents-gov-finance — `hts-usitc-search`) - Health statistics (use pilot-service-agents-health for CDC/WHO)

Public-health and biomedical APIs — ClinicalTrials.gov, openFDA, CDC, WHO, ClinVar, DailyMed, disease.sh. Use this skill when: 1. Searching active/past clinical trials by condition, sponsor, phase 2. Drug label, adverse-event, or interaction lookups (openFDA, DailyMed) 3. COVID / epidemiological stats, WHO global health indicators Do NOT use this skill when: - Running LLM-based medical-advice chats (agents return data only) - Accessing PHI or private clinical records — these are public endpoints - Nutrition / food-product data (use pilot-service-agents-food)

Structured-knowledge and factual lookups — Google Knowledge Graph (premium), DuckDuckGo Instant, Archive.org, holidays, geocoders. Use this skill when: 1. Entity lookups: person, place, organisation, event (Knowledge Graph, Wikidata) 2. Public-holiday calendar for a country/year 3. Archive.org item search Do NOT use this skill when: - Fact-checking of specific claims (use pilot-service-agents-reference — `gcp-fact-check`) - Literature search (use pilot-service-agents-academic)

Language and NLP services — translation, text-to-speech, dictionaries, word tools, Bible text, linguistic corpora. Use this skill when: 1. Translating text between languages (gcp-translate, premium) 2. Finding synonyms, rhymes, related words (Datamuse) 3. Fetching word definitions or dictionary entries Do NOT use this skill when: - Running your own LLM inference — these are specific narrow NLP APIs - Document summarisation (call any agent's /summary subcommand instead)

Music metadata and lyrics — iTunes search and Lyrics.ovh. Use this skill when: 1. Searching iTunes for tracks, podcasts, artists 2. Fetching lyrics by artist + title (Lyrics.ovh) Do NOT use this skill when: - Audio streaming or download — metadata only - Music licensing data

Biodiversity observations — iNaturalist species sightings. Use this skill when: 1. Looking up recent species observations near a location Do NOT use this skill when: - Pet / domestic animal info - Protected-species enforcement data

News feeds, forum aggregators, and current-events streams — Hacker News, dev.to, GDELT, Reddit, Stack Exchange, USGS hazards. Use this skill when: 1. Pulling current tech news / top stories (HN top/new, Lobsters, dev.to) 2. Searching discussion archives (HN Algolia, Stack Exchange) 3. Monitoring real-time events — hurricanes, earthquakes, spaceflight news Do NOT use this skill when: - Mainstream press articles (not in catalogue — use an external news API) - Scholarly literature (use pilot-service-agents-academic) - Sports scores (use pilot-service-agents-sports)

Package-registry metadata — npm, PyPI, Maven Central (Solr-backed). Use this skill when: 1. Checking a package's version, maintainer, dependencies 2. Querying Maven Central for a groupId/artifactId 3. Listing recent PyPI / npm releases Do NOT use this skill when: - Downloading package artifacts — metadata only - crates.io / Docker Hub / GitHub (use pilot-service-agents-dev)

Lightweight utility lookups — dictionaries, jokes, colors, currencies, random facts, D&D data, etc. Use this skill when: 1. Defining a word, expanding an abbreviation, looking up a synonym or rhyme 2. Fetching low-stakes factoids (cat fact, advice, random trivia, D&D reference) 3. Currency codes and latest/historical FX rates (Frankfurter) Do NOT use this skill when: - Live market data or crypto prices (use pilot-service-agents-finance) - Detailed country profiles (use pilot-service-agents-data — e.g. `restcountries-all`) - Knowledge-graph entity lookups (use pilot-service-agents-knowledge)

Primary-source scientific and research APIs — earthquakes, molecules, space weather, particle physics, volcanoes. Use this skill when: 1. Looking up scientific observations (earthquakes, volcanic activity, space events) 2. Searching molecule / drug / chemistry databases (ChEMBL, PubChem) 3. Accessing dataset catalogs from research repositories (Dataverse, CERN) Do NOT use this skill when: - General reference lookups (use pilot-service-agents-reference) - Scholarly paper search (use pilot-service-agents-academic) - Live weather forecasts (use pilot-service-agents-weather)

Security and threat-intel lookups — CVEs, certificate transparency, URL/IP threat checks, DNS, WHOIS. Use this skill when: 1. Looking up a CVE (NVD, MITRE CVE, Shodan CVEDB) 2. Certificate transparency or domain WHOIS / RDAP lookup 3. URL / IP threat classification (Web Risk premium, Mullvad, ProxyCheck) Do NOT use this skill when: - Active scanning or exploitation — these are read-only lookups - Breach-data *exposure* — HIBP agent returns breach descriptors only

Discover and query the pilot-service-agents catalogue — ~370 always-on data agents reachable over Pilot Protocol that wrap real-world APIs (Google Maps, OpenAlex, NHTSA, USGS, CoinGecko, NASA, aviation weather, and many more) so callers don't need their own API keys, rate limits, or HTTP plumbing. Use this skill when: 1. You need to answer a question that depends on up-to-date external data (geography, finance, aviation, science, health, academic literature, etc.) and do not want to hit the upstream APIs yourself. 2. You want to discover which agents exist for a topic before invoking one. 3. You want structured, paginated, filter-driven access to an upstream API without touching its SDK or auth. Do NOT use this skill when: - You want agent-to-agent chat (use pilot-chat instead). - You are looking for swarm/task coordination (use pilot-task-router instead). - You need to run your own data source — these agents are consumer-side only.

Space and astronomy — NASA Astronomy Picture of the Day, Open Notify astronauts. Use this skill when: 1. Fetching APOD metadata + media URLs for a given date 2. Listing who is currently in space (Open Notify) Do NOT use this skill when: - Satellite TLEs / orbital mechanics (not yet in catalogue) - Weather / climate (use respective categories)

Live sports scores, fixtures, and historical stats — MLB, NFL, NHL, NBA, Formula 1, cricket, and generic TheSportsDB. Use this skill when: 1. Live/upcoming game scores and schedules 2. Player, team, or league metadata across multiple sports 3. Formula 1 season standings and race results Do NOT use this skill when: - Sports-betting odds — not in catalogue - Fantasy-league roster management (read-only agents)

Urban transport and bike-share — CityBikes index, GBFS feeds, Transport for London lines/arrivals. Use this skill when: 1. Live bike-share availability at stations (CityBikes, GBFS) 2. Transport for London line status or next arrivals at a stop Do NOT use this skill when: - Road-routing for drivers (use pilot-service-agents-geo for directions) - Rail / regional transit schedules (use pilot-service-agents-transit)

Public-transit schedules and live data — Amtrak, BART, Deutsche Bahn, Swiss SBB, BC Ferries, BVG Berlin, and more. Use this skill when: 1. Live train / ferry / bus departures at a specific stop or station 2. Planning a multi-modal journey between two stops (e.g. Swiss SBB, DB) 3. Station directory lookups (Amtrak, Entur geocoder) Do NOT use this skill when: - City bike-share (use pilot-service-agents-traffic) - Aircraft / flight information (use pilot-service-agents-flights) - Road-routing for cars (use pilot-service-agents-geo)

NHTSA vehicle records — VIN decoder, makes, models, recalls, consumer complaints. Use this skill when: 1. Decoding a VIN to manufacturer / model / year / spec 2. Looking up recalls or complaints for a make/model/year 3. Enumerating models for a given make Do NOT use this skill when: - Vehicle pricing / market value (not in catalogue) - Live telematics / fleet data

Weather forecasts and historical climate — Open-Meteo (forecast, archive, air quality, marine, flood), Seven Timer astronomy. Use this skill when: 1. Current weather or multi-day forecast at a lat/lng 2. Historical weather archive or marine/flood forecasts 3. Air-quality (particulates, ozone, NO2) via Open-Meteo Do NOT use this skill when: - Aviation weather (use pilot-service-agents-flights for METAR/TAF) - Climate-energy info (use pilot-service-agents-climate)

Automatic trust management with configurable policies for Pilot Protocol agents. Use this skill when: 1. You need to auto-approve handshake requests from known agents or networks 2. You want policy-based trust decisions (by network membership, hostname pattern, or tag) 3. You need to batch-process pending trust requests Do NOT use this skill when: - You need manual review of every trust request - You're dealing with unknown or potentially malicious agents - You need fine-grained per-agent trust policies