How do I install the Pilot Archive skill?

Run npx skillmds@latest add teoslayer/pilot-archive 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 Archive 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 Archive?

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 Archive free to use?

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

Who published Pilot Archive?

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

Pilot Archive by teoslayer — Agent Skill

Name: Pilot Archive
Author: TeoSlayer

Pilot Archive

Index and search historical data exchanges, messages, and file transfers over Pilot Protocol. Use this skill when: 1. You need to search through past messages and file transfers 2. You want to maintain searchable history of all agent communications 3. You need to audit or analyze historical data exchange patterns Do NOT use this skill when: - You need real-time data access (use pilot-stream-data instead) - You need active file synchronization (use pilot-sync instead) - You need current inbox messages (use pilotctl inbox directly)

TeoSlayer 1a9fef7 2 files · 3.9 KB Updated Sep 17, 2026

File contents

pilot-archive

Index and search historical data exchanges including messages, file transfers, and communication patterns. This skill provides a searchable archive of all Pilot Protocol communications with metadata indexing, full-text search, and analytics capabilities.

Commands

Index Messages

Build searchable index of message history:

ARCHIVE_DIR="$HOME/.pilot/archive"
INDEX_FILE="$ARCHIVE_DIR/message-index.jsonl"
mkdir -p "$ARCHIVE_DIR"

pilotctl --json inbox | jq -c '.messages[] |
  {timestamp, from, type, content, indexed_at: (now | todate)}' >> "$INDEX_FILE"

Index File Transfers

Record file transfer history:

ARCHIVE_DIR="$HOME/.pilot/archive"
FILE_INDEX="$ARCHIVE_DIR/file-index.jsonl"

pilotctl --json received | jq -c '.received[] |
  {timestamp, from, filename, size, port, indexed_at: (now | todate)}' >> "$FILE_INDEX"

Search Messages

Full-text search through message archive:

KEYWORD="$1"
jq -r "select(.content | test(\"$KEYWORD\"; \"i\")) |
  \"[\(.timestamp)] \(.from): \(.content)\"" "$HOME/.pilot/archive/message-index.jsonl"

Search by Sender

Find all communications from specific agent:

SENDER="1:0001.AAAA.BBBB"
jq -r "select(.from == \"$SENDER\") |
  \"[\(.timestamp)] \(.type): \(.content)\"" \
  "$HOME/.pilot/archive/message-index.jsonl"

Archive Statistics

Generate statistics from archive:

ARCHIVE_DIR="$HOME/.pilot/archive"
MSG_COUNT=$(wc -l < "$ARCHIVE_DIR/message-index.jsonl")
FILE_COUNT=$(wc -l < "$ARCHIVE_DIR/file-index.jsonl")

echo "Total messages: $MSG_COUNT"
echo "Total files: $FILE_COUNT"
echo ""
echo "Top senders:"
jq -r '.from' "$ARCHIVE_DIR/message-index.jsonl" | sort | uniq -c | sort -rn | head -5

Workflow Example

#!/bin/bash
# pilot-archive: Historical data indexing and search

ARCHIVE_DIR="$HOME/.pilot/archive"
MSG_INDEX="$ARCHIVE_DIR/message-index.jsonl"
FILE_INDEX="$ARCHIVE_DIR/file-index.jsonl"

mkdir -p "$ARCHIVE_DIR"

# Index messages (get all, filter client-side)
pilotctl --json inbox | jq -c '.messages[] |
  {timestamp, from, to, type, content, indexed_at: (now | todate)}' | tail -100 >> "$MSG_INDEX"

# Index files (get all, filter client-side)
pilotctl --json received | jq -c '.received[] |
  {timestamp, from, filename, size, port, indexed_at: (now | todate)}' | tail -100 >> "$FILE_INDEX"

# Search archive
search_query="$1"
if [ -n "$search_query" ]; then
  echo "=== Messages ==="
  jq -r "select(.content | test(\"$search_query\"; \"i\")) |
    \"[\(.timestamp)] \(.from): \(.content)\"" "$MSG_INDEX" | head -20
fi

Dependencies

Requires pilot-protocol, jq, tar/gzip for export.

---name: pilot-archivedescription: Index and search historical data exchanges, messages, and file transfers over Pilot Protocol. Use this skill when: 1. You need to search through past messages and file transfers 2. You want to maintain searchable history of all agent communications 3. You need to audit or analyze historical data exchange patterns Do NOT use this skill when: - You need real-time data access (use pilot-stream-data instead) - You need active file synchronization (use pilot-sync instead) - You need current inbox messages (use pilotctl inbox directly)license: AGPL-3.0---# pilot-archiveIndex and search historical data exchanges including messages, file transfers, and communication patterns. This skill provides a searchable archive of all Pilot Protocol communications with metadata indexing, full-text search, and analytics capabilities.## Commands### Index MessagesBuild searchable index of message history:```bashARCHIVE_DIR="$HOME/.pilot/archive"INDEX_FILE="$ARCHIVE_DIR/message-index.jsonl"mkdir -p "$ARCHIVE_DIR"pilotctl --json inbox | jq -c '.messages[] | {timestamp, from, type, content, indexed_at: (now | todate)}' >> "$INDEX_FILE"```### Index File TransfersRecord file transfer history:```bashARCHIVE_DIR="$HOME/.pilot/archive"FILE_INDEX="$ARCHIVE_DIR/file-index.jsonl"pilotctl --json received | jq -c '.received[] | {timestamp, from, filename, size, port, indexed_at: (now | todate)}' >> "$FILE_INDEX"```### Search MessagesFull-text search through message archive:```bashKEYWORD="$1"jq -r "select(.content | test(\"$KEYWORD\"; \"i\")) | \"[\(.timestamp)] \(.from): \(.content)\"" "$HOME/.pilot/archive/message-index.jsonl"```### Search by SenderFind all communications from specific agent:```bashSENDER="1:0001.AAAA.BBBB"jq -r "select(.from == \"$SENDER\") | \"[\(.timestamp)] \(.type): \(.content)\"" \ "$HOME/.pilot/archive/message-index.jsonl"```### Archive StatisticsGenerate statistics from archive:```bashARCHIVE_DIR="$HOME/.pilot/archive"MSG_COUNT=$(wc -l < "$ARCHIVE_DIR/message-index.jsonl")FILE_COUNT=$(wc -l < "$ARCHIVE_DIR/file-index.jsonl")echo "Total messages: $MSG_COUNT"echo "Total files: $FILE_COUNT"echo ""echo "Top senders:"jq -r '.from' "$ARCHIVE_DIR/message-index.jsonl" | sort | uniq -c | sort -rn | head -5```## Workflow Example```bash#!/bin/bash# pilot-archive: Historical data indexing and searchARCHIVE_DIR="$HOME/.pilot/archive"MSG_INDEX="$ARCHIVE_DIR/message-index.jsonl"FILE_INDEX="$ARCHIVE_DIR/file-index.jsonl"mkdir -p "$ARCHIVE_DIR"# Index messages (get all, filter client-side)pilotctl --json inbox | jq -c '.messages[] | {timestamp, from, to, type, content, indexed_at: (now | todate)}' | tail -100 >> "$MSG_INDEX"# Index files (get all, filter client-side)pilotctl --json received | jq -c '.received[] | {timestamp, from, filename, size, port, indexed_at: (now | todate)}' | tail -100 >> "$FILE_INDEX"# Search archivesearch_query="$1"if [ -n "$search_query" ]; then echo "=== Messages ===" jq -r "select(.content | test(\"$search_query\"; \"i\")) | \"[\(.timestamp)] \(.from): \(.content)\"" "$MSG_INDEX" | head -20fi```## DependenciesRequires pilot-protocol, jq, tar/gzip for export.

Frequently asked questions