Pilot Share

核心功能：基于Pilot协议实现一键分享单文件或目录，自带进度追踪、传输失败自动重试，支持查看已接收分享记录。典型场景：需快速向其他Agent分享文件/目录，且需确认进度、保障传输成功率的场景；不适合双向同步、实时流或持久共享需求。通过Bash命令调用pilotctl，输入文件路径与目标标识，输出JSON格式结果。

teoslayer

热度 46.41

最近更新 2026-05-11 17:41:37

分类：自动化依赖：代码执行 / 读写文件 / 第三方 API应用场景：自动化脚本 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add pilot-share

Metadata

name: pilot-share
description: One-click file sharing with progress tracking and automatic retry over Pilot Protocol. Use this skill when: 1. You need to quickly share a single file or directory with another agent 2. You want progress tracking and confirmation for file transfers 3. You need automatic retry on transfer failure Do NOT use this skill when: - You need bidirectional synchronization (use pilot-sync instead) - You need to stream data in real-time (use pilot-stream-data instead) - You need to maintain a persistent shared folder (use pilot-dropbox)
tags: ["pilot-protocol","file-transfer","sharing","one-shot"]
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-share

One-click file sharing between agents with progress tracking and automatic retry.

Commands

Share single file

pilotctl --json send-file 1:0001.AAAA.BBBB /path/to/document.pdf

Share directory

DIR="/path/to/share"
ARCHIVE="/tmp/$(basename $DIR).tar.gz"

tar czf "$ARCHIVE" -C "$(dirname $DIR)" "$(basename $DIR)"
pilotctl --json send-file "$DEST" "$ARCHIVE"
rm "$ARCHIVE"

List received shares

pilotctl --json received | jq -r '.received[] | "\(.timestamp) \(.filename) (\(.size) bytes)"'

Workflow Example

Share file with retry:

#!/bin/bash
DEST="1:0001.AAAA.BBBB"
FILE="/path/to/large-file.zip"
MAX_RETRIES=3

for RETRY in $(seq 1 $MAX_RETRIES); do
  echo "Attempt $RETRY/$MAX_RETRIES"

  if pilotctl --json send-file "$DEST" "$FILE" | jq -e '.success'; then
    echo "Transfer successful!"
    break
  fi

  [ $RETRY -lt $MAX_RETRIES ] && sleep 5
done

Dependencies

Requires pilot-protocol skill, pilotctl, jq, and tar.