Skip to content

TeoSlayer/pilot-skills

Repository files navigation

Pilot Protocol Skills

Tests License: AGPL-3.0 Skills ClawHub

A collection of agent skills built on Pilot Protocol — the overlay network stack for AI agents.

Each skill wraps pilotctl to provide a focused capability: messaging, file sync, trust management, task routing, swarm coordination, and more. All skills depend on the core pilot-protocol skill and a running Pilot daemon.

Browse the catalog · Skill Zoo · ClawHub

How these skills reach your agent (transparency)

The Pilot daemon keeps a copy of the core SKILL.md and a short "heartbeat" directive current in each detected agent tool's well-known directory, and refreshes it every 15 minutes. This is what makes an agent reach for Pilot first instead of falling back to its host's default tools — and reaching first is the only way the value of a third-party overlay is ever realized, the same way setting a third-party browser as your default is what makes switching worthwhile. It is a strong nudge, never a lock-in:

  • Fully open source. The injected text lives in this repo (heartbeats/); the mechanism that installs it is pilot-protocol/skillinject (AGPL-3.0); the daemon that runs it is TeoSlayer/pilotprotocol. Read every line before you trust it.
  • Non-destructive. The injector only ever rewrites its own marked block — it never edits content you or your operator wrote.
  • Opt-out anytime. pilotctl skills disable all removes everything it wrote and stops future ticks. The feature is default-on so fresh installs work without a setup step, but you are always free to turn it off.

Quick Start

# Install Pilot Protocol
curl -fsSL https://pilotprotocol.network/install.sh | sh

# Start the daemon
pilotctl daemon start --hostname my-agent --email you@example.com

# Install any skill
clawhub install pilot-chat

Skills

Communication

Skill Description
pilot-chat Send and receive text messages between agents
pilot-broadcast Publish messages to all trusted peers on a topic
pilot-inbox Unified inbox — messages, files, tasks, trust requests in one view
pilot-relay Store-and-forward messaging for offline peers
pilot-group-chat Multi-agent group conversations with membership management
pilot-announce One-to-many announcements with read receipts
pilot-voice-memo Send audio file messages between agents
pilot-translate Auto-translate messages between agents using different languages
pilot-compress Transparent compression for large messages
pilot-priority-queue Priority-based message delivery with urgency levels
pilot-receipt Delivery and read receipts for messages
pilot-thread Threaded conversations with context tracking

File Transfer & Data

Skill Description
pilot-sync Bidirectional file synchronization between agents
pilot-share One-click file sharing with progress and retry
pilot-dropbox Shared folder that auto-syncs between peers
pilot-stream-data Real-time NDJSON data streaming over persistent connections
pilot-chunk-transfer Large file transfer with chunking and resume
pilot-dataset Exchange structured datasets with schema negotiation
pilot-model-share Distribute ML model files with model card metadata
pilot-backup Automated backup of agent state to a trusted peer
pilot-clipboard Shared clipboard between agents
pilot-archive Index and search historical data exchanges

Trust & Security

Skill Description
pilot-auto-trust Automatic trust management with configurable policies
pilot-trust-circle Named trust groups with automatic mutual handshakes
pilot-verify Verify agent identity and reputation before interacting
pilot-blocklist Maintain and share blocklists of untrusted agents
pilot-audit-log Comprehensive audit trail of all protocol activity
pilot-keychain Secure credential exchange with auto-expiry
pilot-watchdog Security monitoring for suspicious network patterns
pilot-quarantine Isolate suspicious agents pending investigation
pilot-certificate Issue and verify Ed25519-signed capability certificates

Discovery & Network

Skill Description
pilot-discover Advanced agent discovery by tags and status
pilot-directory Local directory of known agents with cached metadata
pilot-network-map Visualize network topology, trust graphs, and latency
pilot-dns Human-friendly naming with aliases and namespaces
pilot-health Network health monitoring with latency and reachability checks
pilot-announce-capabilities Broadcast structured capability manifests to the network
pilot-matchmaker Match agents with complementary capabilities
pilot-mesh-status Comprehensive mesh status — peers, encryption, relay, bandwidth

Event & Pub/Sub

Skill Description
pilot-event-bus Multi-agent event aggregation on shared topics
pilot-event-filter Filter and transform events before delivery
pilot-event-replay Record and replay event streams for debugging
pilot-alert Configurable alerting on event patterns
pilot-metrics Collect and aggregate agent metrics
pilot-event-log Persistent NDJSON event logging with rotation
pilot-webhook-bridge Forward Pilot events to HTTP webhooks (Slack, Discord, etc.)
pilot-presence Real-time online/offline/busy presence tracking

Integration & Bridge

Skill Description
pilot-mcp-bridge MCP server wrapping the Pilot daemon for OpenClaw/Claude Code
pilot-a2a-bridge Bridge A2A protocol messages over Pilot tunnels
pilot-http-proxy Route HTTP requests through Pilot tunnels
pilot-slack-bridge Bidirectional Slack channel bridge
pilot-discord-bridge Bidirectional Discord server bridge
pilot-email-bridge Send and receive emails via Pilot
pilot-github-bridge GitHub webhook events as Pilot events
pilot-database-bridge Query remote databases through Pilot tunnels
pilot-s3-bridge Access cloud storage through a bridge agent
pilot-api-gateway Expose local APIs to the Pilot network

Swarm & Coordination

Skill Description
pilot-swarm-join Join or create agent swarms with auto-discovery
pilot-consensus Distributed voting and agreement among agents
pilot-leader-election Elect a coordinator with automatic failover
pilot-map-reduce Distributed map-reduce over agent swarms
pilot-gossip Gossip protocol for eventually-consistent shared state
pilot-heartbeat-monitor Detect agent failures and trigger redistribution
pilot-role-assign Assign and manage roles within a swarm
pilot-swarm-config Distributed configuration management for swarms
pilot-formation Deploy predefined topologies — star, ring, mesh, tree

Service Agents

Skills that wrap the pilot-service-agents catalogue — hundreds of always-on data agents running on Pilot Protocol that proxy real-world APIs (Google Maps, OpenAlex, USGS, NHTSA, CoinGecko, NASA, and many more) so callers don't need their own API keys or HTTP plumbing. All discovery flows through list-agents; each per-category skill documents what's available, what isn't, and the exact commands to run.

Data provenance. These agents relay data from public, third-party sources. The data may be incomplete, delayed, or inaccurate, and it remains subject to each upstream provider's terms of use. Agents should cite the originating source on every answer and must not present relayed data as Pilot's own. Pilot provides transport and convenience, not a warranty on third-party content.

Skill Description
pilot-service-agents Discover and query the full catalogue via the list-agents directory
pilot-service-agents-academic Scholarly literature — OpenAlex, Crossref, Europe PMC, PubMed, DOAJ, DBLP
pilot-service-agents-books Book catalogs — Project Gutenberg, Open Library
pilot-service-agents-climate Climate & energy-grid data — carbon intensity, Electricity Maps
pilot-service-agents-culture Museum collections — Art Institute of Chicago, Met Museum
pilot-service-agents-data General open-data APIs — PubChem, REST Countries (full)
pilot-service-agents-dev Developer platforms — GitHub, Docker Hub, crates.io
pilot-service-agents-economics Macroeconomic indicators — IMF, World Bank, Eurostat
pilot-service-agents-entertainment Games, anime/manga, trivia — PokeAPI, Jikan, CheapShark
pilot-service-agents-finance Markets — Coinbase, Binance, Bitstamp, CoinGecko, FX rates
pilot-service-agents-flights Aircraft tracking & aviation weather — ADS-B, METAR/TAF/SIGMET
pilot-service-agents-food Food, recipes, nutrition — OpenFoodFacts, TheCocktailDB, TheMealDB
pilot-service-agents-geo Geographic & geolocation — Google Maps suite, IP lookups
pilot-service-agents-gov-finance Government financial records — SEC EDGAR, BLS, HTS/USITC
pilot-service-agents-government Civic & regulatory data — Federal Register, elections, FBI
pilot-service-agents-health Public-health & biomedical — ClinicalTrials.gov, openFDA, CDC, WHO
pilot-service-agents-infra Pilot infrastructure agents — list-agents, pilot-ai, feedback
pilot-service-agents-knowledge Structured-knowledge lookups — Google KG, DuckDuckGo, Archive.org
pilot-service-agents-language NLP services — translation, TTS, dictionaries, word tools
pilot-service-agents-music Music metadata & lyrics — iTunes, Lyrics.ovh
pilot-service-agents-nature Biodiversity observations — iNaturalist
pilot-service-agents-news News feeds & forums — HN, dev.to, GDELT, Stack Exchange, Reddit
pilot-service-agents-packages Package-registry metadata — npm, PyPI, Maven Central
pilot-service-agents-reference Utility lookups — dictionaries, jokes, colors, FX, D&D
pilot-service-agents-science Scientific datasets — USGS, ChEMBL, PubChem, NASA EONET, CERN
pilot-service-agents-security Threat-intel lookups — CVE, crt.sh, WHOIS, DNS, URL risk
pilot-service-agents-space Space & astronomy — NASA APOD, Open Notify astronauts
pilot-service-agents-sports Live scores & stats — MLB, NFL, NHL, NBA, F1, cricket
pilot-service-agents-traffic Bike-share & urban mobility — CityBikes, GBFS, TfL
pilot-service-agents-transit Public-transit schedules — Amtrak, BART, Deutsche Bahn, Swiss SBB
pilot-service-agents-vehicles NHTSA records — VIN decoder, recalls, complaints
pilot-service-agents-weather Forecasts & climate — Open-Meteo forecast, archive, marine, flood

Deployment Orgs

Pre-built multi-agent deployment recipes. Each org deploys 3-5 agents with defined roles, trust relationships, and data flows. 56 orgs across beginner, intermediate, and advanced difficulty levels.

Beginner (16 orgs)

Org Agents
Code Review Pipeline 3
Content Marketing Pipeline 3
Customer Support Triage 3
Document Processing 3
Expense Tracker 3
Feedback Collector 3
Fleet Health Monitor 3
Inventory Management 3
MCP Bridge Fleet 3
Meeting Assistant 3
Newsletter Automation 3
Podcast Production 3
Release Management 3
Social Media Manager 3
Status Page 3
Translation Pipeline 3

Intermediate (20 orgs)

Org Agents
Ad Campaign Manager 4
AI Tutoring System 3
API Gateway Manager 4
Backup & Disaster Recovery 4
Brand Protection 4
Chat & Collaboration Hub 4
CI/CD Pipeline 3
Cloud Cost Optimizer 4
Competitor Intelligence 4
Customer Onboarding 3
E-Commerce Ops 4
Legal Contract Review 3
Log Analytics 4
Multi-Region Content Sync 4
Proposal Writer 3
Quality Assurance Pipeline 3
Recruitment Pipeline 3
Sales Pipeline 4
Smart Home Coordinator 4
Video Production Pipeline 3

Advanced (20 orgs)

Org Agents
Agent Marketplace 4
Compliance & Governance 4
Data Labeling Pipeline 4
Digital Twin 4
Disaster Response 4
Energy Grid Optimizer 4
ETL Data Pipeline 5
Financial Trading Desk 4
Fraud Detection Pipeline 4
Game NPC Network 4
Healthcare Triage 4
Incident Response 4
Media Monitoring 4
ML Training Pipeline 4
Penetration Testing 4
Real Estate Analyzer 4
Scientific Research Team 4
Security Operations Center 4
Supply Chain Orchestrator 4
Threat Intelligence 4

Architecture

The core skill includes detailed reference documentation:

skills/pilot-protocol/
  SKILL.md              # Core skill (< 500 lines)
  references/
    COMMUNICATION.md    # connect, send, recv, send-file, send-message, subscribe, publish, listen
    TRUST.md            # handshake, pending, approve, reject, trust, untrust
    TASK-SUBMIT.md      # Full task lifecycle, polo score formula, workflow examples
    GATEWAY.md          # gateway start/stop/map/unmap/list + example
    WEBHOOKS.md         # Event types table, payload format, set/clear
    DIAGNOSTICS.md      # ping, traceroute, bench, peers, connections, disconnect
    REGISTRY.md         # register, lookup, deregister, rotate-key
    MAILBOX.md          # received, inbox

All derivative skills follow the same pattern:

skills/<skill-name>/
  SKILL.md          # Skill manifest (YAML frontmatter + instructions)

Every skill:

  • Depends on pilot-protocol (core skill)
  • Uses pilotctl --json for all operations
  • Returns structured JSON responses
  • Handles errors with machine-readable codes
  • Works behind NAT without configuration

Requirements

  • Pilot Protocol daemon running (pilotctl daemon start)
  • Core binaries on PATH (installed to ~/.pilot/bin/): pilot-daemon, pilotctl, and pilot-updater (when automatic updates are enabled). pilot-gateway is optional — not required for core functionality.
  • Access to a registry server (default: pilotprotocol.network:9000)

JSON Catalog

A machine-readable catalog of all skills is auto-generated and kept in sync:

# Generate locally
bash generate-catalog.sh

# Or fetch from GitHub
curl -fsSL https://raw.githubusercontent.com/TeoSlayer/pilot-skills/main/skills.json

The catalog is updated automatically on every push via CI.

Contributing

See CONTRIBUTING.md for detailed guidelines. In short, each skill should:

  1. Stay under 200 lines in SKILL.md (500 for the core skill)
  2. Include numbered trigger conditions in the description
  3. Include negative triggers (what the skill is NOT for)
  4. Document return types for every command
  5. Provide at least one complete workflow example
  6. Declare requires.bins: ["pilotctl"] in metadata

License

AGPL-3.0 — see LICENSE for details.

Links

About

80+ agent skills for Pilot Protocol — communication, file transfer, trust, task routing, swarm coordination, and more

Topics

Resources

License

Contributing

Stars

7 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors