How do I install the Pilot Dropbox skill?

Run npx skillmds@latest add teoslayer/pilot-dropbox in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Pilot Dropbox safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Pilot Dropbox?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Pilot Dropbox free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under AGPL-3.

Who published Pilot Dropbox?

TeoSlayer (@teoslayer) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Pilot Dropbox by teoslayer — Agent Skill

Name: Pilot Dropbox
Author: TeoSlayer

Pilot Dropbox

Shared folder that automatically synchronizes between peers using Pilot Protocol pub/sub. Use this skill when: 1. You need a persistent shared folder that stays in sync across agents 2. You want automatic file synchronization without manual intervention 3. You need multi-peer folder sharing with eventual consistency Do NOT use this skill when: - You only need one-time file transfer (use pilot-share instead) - You need strict consistency guarantees (use pilot-sync with locks) - You need real-time streaming (use pilot-stream-data instead)

TeoSlayer c2f1ab2 2 files · 3.7 KB Updated Sep 17, 2026

File contents

pilot-dropbox

Shared folder implementation using Pilot Protocol pub/sub and file transfer. Provides Dropbox-like functionality with eventual consistency.

Essential Commands

Create and join shared folder

DROPBOX_DIR="$HOME/pilot-dropbox"
PEER="agent-b"
TOPIC="team-shared"
mkdir -p "$DROPBOX_DIR"

pilotctl --json subscribe "$PEER" "$TOPIC"

Publish file to folder

cp "$FILE" "$DROPBOX_DIR/"
FILENAME=$(basename "$FILE")
HASH=$(md5sum "$DROPBOX_DIR/$FILENAME" | cut -d' ' -f1)

pilotctl --json publish "$PEER" "$TOPIC" \
  --data "{\"type\":\"file_added\",\"filename\":\"$FILENAME\",\"hash\":\"$HASH\"}"

Remove file from folder

rm "$DROPBOX_DIR/$FILENAME"
pilotctl --json publish "$PEER" "$TOPIC" \
  --data "{\"type\":\"file_removed\",\"filename\":\"$FILENAME\"}"

Watch folder for changes

fswatch -0 "$DROPBOX_DIR" | while read -d "" changed_file; do
  [ -f "$changed_file" ] || continue
  FILENAME=$(basename "$changed_file")
  HASH=$(md5sum "$changed_file" | cut -d' ' -f1)
  pilotctl --json publish "$PEER" "$TOPIC" \
    --data "{\"type\":\"file_changed\",\"filename\":\"$FILENAME\",\"hash\":\"$HASH\"}"
done &

Workflow Example

Shared folder daemon:

#!/bin/bash
DROPBOX_DIR="$HOME/pilot-dropbox"
PEER="${1:-agent-b}"
TOPIC="team-shared"

mkdir -p "$DROPBOX_DIR"

# Listen for events
pilotctl --json subscribe "$PEER" "$TOPIC" | while read -r event; do
  TYPE=$(echo "$event" | jq -r '.type')
  FROM=$(echo "$event" | jq -r '.from')

  case "$TYPE" in
    file_added)
      FILENAME=$(echo "$event" | jq -r '.filename')
      HASH=$(echo "$event" | jq -r '.hash')

      if [ -f "$DROPBOX_DIR/$FILENAME" ]; then
        LOCAL_HASH=$(md5sum "$DROPBOX_DIR/$FILENAME" | cut -d' ' -f1)
        [ "$LOCAL_HASH" = "$HASH" ] && continue
      fi

      echo "Pulling: $FILENAME from $FROM"
      pilotctl --json send-message "$FROM" \
        --data "{\"type\":\"dropbox_pull\",\"filename\":\"$FILENAME\"}"
      ;;

    file_removed)
      FILENAME=$(echo "$event" | jq -r '.filename')
      rm -f "$DROPBOX_DIR/$FILENAME"
      ;;

    dropbox_pull)
      FILENAME=$(echo "$event" | jq -r '.filename')
      pilotctl --json send-file "$FROM" "$DROPBOX_DIR/$FILENAME"
      ;;
  esac
done

Dependencies

Requires pilot-protocol skill, pilotctl, jq, fswatch (macOS) or inotifywait (Linux), and file utilities.

---name: pilot-dropboxdescription: Shared folder that automatically synchronizes between peers using Pilot Protocol pub/sub. Use this skill when: 1. You need a persistent shared folder that stays in sync across agents 2. You want automatic file synchronization without manual intervention 3. You need multi-peer folder sharing with eventual consistency Do NOT use this skill when: - You only need one-time file transfer (use pilot-share instead) - You need strict consistency guarantees (use pilot-sync with locks) - You need real-time streaming (use pilot-stream-data instead)license: AGPL-3.0---# pilot-dropboxShared folder implementation using Pilot Protocol pub/sub and file transfer. Provides Dropbox-like functionality with eventual consistency.## Essential Commands### Create and join shared folder```bashDROPBOX_DIR="$HOME/pilot-dropbox"PEER="agent-b"TOPIC="team-shared"mkdir -p "$DROPBOX_DIR"pilotctl --json subscribe "$PEER" "$TOPIC"```### Publish file to folder```bashcp "$FILE" "$DROPBOX_DIR/"FILENAME=$(basename "$FILE")HASH=$(md5sum "$DROPBOX_DIR/$FILENAME" | cut -d' ' -f1)pilotctl --json publish "$PEER" "$TOPIC" \ --data "{\"type\":\"file_added\",\"filename\":\"$FILENAME\",\"hash\":\"$HASH\"}"```### Remove file from folder```bashrm "$DROPBOX_DIR/$FILENAME"pilotctl --json publish "$PEER" "$TOPIC" \ --data "{\"type\":\"file_removed\",\"filename\":\"$FILENAME\"}"```### Watch folder for changes```bashfswatch -0 "$DROPBOX_DIR" | while read -d "" changed_file; do [ -f "$changed_file" ] || continue FILENAME=$(basename "$changed_file") HASH=$(md5sum "$changed_file" | cut -d' ' -f1) pilotctl --json publish "$PEER" "$TOPIC" \ --data "{\"type\":\"file_changed\",\"filename\":\"$FILENAME\",\"hash\":\"$HASH\"}"done &```## Workflow ExampleShared folder daemon:```bash#!/bin/bashDROPBOX_DIR="$HOME/pilot-dropbox"PEER="${1:-agent-b}"TOPIC="team-shared"mkdir -p "$DROPBOX_DIR"# Listen for eventspilotctl --json subscribe "$PEER" "$TOPIC" | while read -r event; do TYPE=$(echo "$event" | jq -r '.type') FROM=$(echo "$event" | jq -r '.from') case "$TYPE" in file_added) FILENAME=$(echo "$event" | jq -r '.filename') HASH=$(echo "$event" | jq -r '.hash') if [ -f "$DROPBOX_DIR/$FILENAME" ]; then LOCAL_HASH=$(md5sum "$DROPBOX_DIR/$FILENAME" | cut -d' ' -f1) [ "$LOCAL_HASH" = "$HASH" ] && continue fi echo "Pulling: $FILENAME from $FROM" pilotctl --json send-message "$FROM" \ --data "{\"type\":\"dropbox_pull\",\"filename\":\"$FILENAME\"}" ;; file_removed) FILENAME=$(echo "$event" | jq -r '.filename') rm -f "$DROPBOX_DIR/$FILENAME" ;; dropbox_pull) FILENAME=$(echo "$event" | jq -r '.filename') pilotctl --json send-file "$FROM" "$DROPBOX_DIR/$FILENAME" ;; esacdone```## DependenciesRequires `pilot-protocol` skill, `pilotctl`, `jq`, `fswatch` (macOS) or `inotifywait` (Linux), and file utilities.

Frequently asked questions