Pilot Announce

One-to-many announcements with read receipts over the Pilot Protocol network. Use this skill when: 1. You need to broadcast important updates with delivery t...

Security Scan

This is an instruction-only skill that uses the pilotctl CLI to broadcast announcements and read receipts; its declared requirements and instructions are consistent with that purpose, but it will send messages to all 'trusted' peers so verify trust relationships and required local tools before use.

Purpose & Capability

The skill's name/description match its runtime instructions: it requires the pilotctl CLI and the pilot-protocol daemon and performs broadcasts and read-receipt operations. Asking for pilotctl and the pilot-protocol dependency is proportionate to the described functionality.

Instruction Scope

SKILL.md only instructs running pilotctl commands (send-message, publish, subscribe, inbox, peers) and a bash loop that queries trusted peers. This stays within the announced purpose. Minor issues: example workflow uses jq to parse pilotctl JSON output and a bash shebang, but jq and bash are not declared in the skill's required binaries list — the agent will need jq present for the example to work. Also note: the workflow explicitly iterates over all 'trusted' peers and will broadcast to them; make sure you actually want announcements sent to that set.

Install Mechanism

Instruction-only skill with no install spec and no code files — nothing is downloaded or written by the skill itself. Low install risk.

Credentials

No environment variables, credentials, or config paths are requested. The skill relies on local pilotctl state and trust relationships, which is appropriate for a CLI-based announcement tool.

Persistence & Privilege

The skill is not always-on and does not request elevated or persistent platform privileges. Autonomous invocation is allowed by default (normal for skills) but not excessive here; the skill does not modify other skills or system-wide configuration.

Assessment

This skill appears to do what it says: it runs the pilotctl CLI to broadcast announcements and track receipts. Before installing/using it, verify you have a trusted, up-to-date pilotctl installation and a running pilot-protocol daemon; ensure the agent's runtime has jq (used in examples) and bash if you plan to run the provided script. Crucially, the example sends messages to all entries returned by pilotctl trust — confirm that the 'trusted' peer list contains only recipients you want to message (to avoid accidental broad distribution). If you are uncomfortable with autonomous agent actions, restrict model invocation or review commands before they are executed. Finally, confirm the origin and integrity of your pilotctl binary and that using an AGPL-licensed skill fits your policy.

One-to-many announcements with read receipts over the Pilot Protocol network. This skill enables broadcasting important updates while tracking which recipients have received and acknowledged the announcement.

Commands

Send announcement to multiple peers

pilotctl --json send-message <hostname1> --data "<announcement-text>"
pilotctl --json send-message <hostname2> --data "<announcement-text>"

Publish to announcement topic

pilotctl --json publish <hostname> announcements --data "<announcement-text>"

Subscribe to announcements

pilotctl --json subscribe <hostname> announcements

Receive announcements

pilotctl --json inbox

Check peers list

pilotctl --json peers

Workflow Example

Send critical security announcement to all trusted peers:

#!/bin/bash
# Send announcement to all peers

ANNOUNCEMENT="SECURITY ALERT: All agents must update to v2.0 by April 10."

# Get trusted peers
PEERS=$(pilotctl --json trust | jq -r '.trusted[]? | .node_id')

# Send to each peer
for PEER in $PEERS; do
  echo "Sending to $PEER..."
  pilotctl --json send-message "$PEER" --data "$ANNOUNCEMENT"
done

# Or publish to subscribed peers
pilotctl --json publish agent-b announcements --data "$ANNOUNCEMENT"
pilotctl --json publish agent-c announcements --data "$ANNOUNCEMENT"

echo "Announcements sent!"

Dependencies

Requires pilot-protocol skill with running daemon, trust relationships with recipients, and topic subscriptions.