How do I install the Pilot Blocklist skill?

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

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

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

Who published Pilot Blocklist?

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

Pilot Blocklist by teoslayer — Agent Skill

Name: Pilot Blocklist
Author: TeoSlayer

Pilot Blocklist

Maintain and share blocklists of untrusted agents in Pilot Protocol networks. Use this skill when: 1. You need to block malicious or compromised agents from connecting 2. You want to share blocklists across multiple agents in your network 3. You need to maintain a persistent deny-list for security Do NOT use this skill when: - You need temporary connection filtering (use firewall rules) - You're managing trust approvals (use pilot-auto-trust) - You need allowlist-only mode (use trust circles instead)

TeoSlayer 2dcd209 2 files · 3.9 KB Updated Sep 17, 2026

File contents

Pilot Blocklist

Manage blocklists of untrusted agents with support for sharing and synchronization across networks.

Commands

Create blocklist:

mkdir -p ~/.pilot/blocklists
cat > ~/.pilot/blocklists/default.json <<EOF
{"name":"default","description":"Primary blocklist","entries":[]}
EOF

Add agent to blocklist:

AGENT="malicious.pilot"
NODE_ID=$(pilotctl --json find "$AGENT" | jq -r '.[0].node_id')

# Untrust and reject
pilotctl --json untrust "$NODE_ID"
pilotctl --json reject "$NODE_ID" "Spam activity"

# Add to blocklist
jq --arg agent "$AGENT" --arg node "$NODE_ID" --arg reason "Spam activity" \
  '.entries += [{hostname: $agent, node_id: $node, reason: $reason, blocked_at: (now | strftime("%Y-%m-%dT%H:%M:%SZ"))}]' \
  ~/.pilot/blocklists/default.json > /tmp/blocklist.json && mv /tmp/blocklist.json ~/.pilot/blocklists/default.json

Remove from blocklist:

jq --arg agent "$AGENT" '.entries = [.entries[] | select(.hostname != $agent)]' \
  ~/.pilot/blocklists/default.json > /tmp/blocklist.json && mv /tmp/blocklist.json ~/.pilot/blocklists/default.json

List blocked agents:

jq -r '.entries[] | "\(.hostname) - \(.reason)"' ~/.pilot/blocklists/default.json

Enforce blocklist:

BLOCKED=$(jq -r '.entries[].hostname' ~/.pilot/blocklists/default.json)

# Reject pending handshakes from blocked agents
pilotctl --json pending | jq -r '.[] | .hostname' | while read -r HOSTNAME; do
  if echo "$BLOCKED" | grep -q "^${HOSTNAME}$"; then
    NODE_ID=$(pilotctl --json pending | jq -r --arg h "$HOSTNAME" '.[] | select(.hostname == $h) | .node_id')
    pilotctl --json reject "$NODE_ID" "Blocklisted"
  fi
done

Workflow Example

#!/bin/bash
# Automatic blocklist enforcement

BLOCKLIST=~/.pilot/blocklists/default.json

block_agent() {
  local AGENT=$1
  local REASON=$2

  NODE_ID=$(pilotctl --json find "$AGENT" | jq -r '.[0].node_id')
  pilotctl --json untrust "$NODE_ID" 2>/dev/null || true

  jq --arg agent "$AGENT" --arg node "$NODE_ID" --arg reason "$REASON" \
    '.entries += [{hostname: $agent, node_id: $node, reason: $reason, blocked_at: (now | strftime("%Y-%m-%dT%H:%M:%SZ"))}] | .entries |= unique_by(.hostname)' \
    "$BLOCKLIST" > /tmp/blocklist.json && mv /tmp/blocklist.json "$BLOCKLIST"
}

# Block peers with hostnames matching a blacklist pattern
pilotctl --json peers | jq -r '.[] | select(.hostname | test("^untrusted-|-evil$")) | .hostname' | \
while read -r AGENT; do
  block_agent "$AGENT" "Hostname on blocklist"
done

echo "Blocklist enforcement complete"

Dependencies

Requires pilot-protocol skill, pilotctl binary, running daemon, and jq for JSON management.

---name: pilot-blocklistdescription: Maintain and share blocklists of untrusted agents in Pilot Protocol networks. Use this skill when: 1. You need to block malicious or compromised agents from connecting 2. You want to share blocklists across multiple agents in your network 3. You need to maintain a persistent deny-list for security Do NOT use this skill when: - You need temporary connection filtering (use firewall rules) - You're managing trust approvals (use pilot-auto-trust) - You need allowlist-only mode (use trust circles instead)license: AGPL-3.0---# Pilot BlocklistManage blocklists of untrusted agents with support for sharing and synchronization across networks.## Commands**Create blocklist:**```bashmkdir -p ~/.pilot/blocklistscat > ~/.pilot/blocklists/default.json <<EOF{"name":"default","description":"Primary blocklist","entries":[]}EOF```**Add agent to blocklist:**```bashAGENT="malicious.pilot"NODE_ID=$(pilotctl --json find "$AGENT" | jq -r '.[0].node_id')# Untrust and rejectpilotctl --json untrust "$NODE_ID"pilotctl --json reject "$NODE_ID" "Spam activity"# Add to blocklistjq --arg agent "$AGENT" --arg node "$NODE_ID" --arg reason "Spam activity" \ '.entries += [{hostname: $agent, node_id: $node, reason: $reason, blocked_at: (now | strftime("%Y-%m-%dT%H:%M:%SZ"))}]' \ ~/.pilot/blocklists/default.json > /tmp/blocklist.json && mv /tmp/blocklist.json ~/.pilot/blocklists/default.json```**Remove from blocklist:**```bashjq --arg agent "$AGENT" '.entries = [.entries[] | select(.hostname != $agent)]' \ ~/.pilot/blocklists/default.json > /tmp/blocklist.json && mv /tmp/blocklist.json ~/.pilot/blocklists/default.json```**List blocked agents:**```bashjq -r '.entries[] | "\(.hostname) - \(.reason)"' ~/.pilot/blocklists/default.json```**Enforce blocklist:**```bashBLOCKED=$(jq -r '.entries[].hostname' ~/.pilot/blocklists/default.json)# Reject pending handshakes from blocked agentspilotctl --json pending | jq -r '.[] | .hostname' | while read -r HOSTNAME; do if echo "$BLOCKED" | grep -q "^${HOSTNAME}$"; then NODE_ID=$(pilotctl --json pending | jq -r --arg h "$HOSTNAME" '.[] | select(.hostname == $h) | .node_id') pilotctl --json reject "$NODE_ID" "Blocklisted" fidone```## Workflow Example```bash#!/bin/bash# Automatic blocklist enforcementBLOCKLIST=~/.pilot/blocklists/default.jsonblock_agent() { local AGENT=$1 local REASON=$2 NODE_ID=$(pilotctl --json find "$AGENT" | jq -r '.[0].node_id') pilotctl --json untrust "$NODE_ID" 2>/dev/null || true jq --arg agent "$AGENT" --arg node "$NODE_ID" --arg reason "$REASON" \ '.entries += [{hostname: $agent, node_id: $node, reason: $reason, blocked_at: (now | strftime("%Y-%m-%dT%H:%M:%SZ"))}] | .entries |= unique_by(.hostname)' \ "$BLOCKLIST" > /tmp/blocklist.json && mv /tmp/blocklist.json "$BLOCKLIST"}# Block peers with hostnames matching a blacklist patternpilotctl --json peers | jq -r '.[] | select(.hostname | test("^untrusted-|-evil$")) | .hostname' | \while read -r AGENT; do block_agent "$AGENT" "Hostname on blocklist"doneecho "Blocklist enforcement complete"```## DependenciesRequires `pilot-protocol` skill, `pilotctl` binary, running daemon, and `jq` for JSON management.

Frequently asked questions

Pilot Blocklist

File contents

Pilot Blocklist

Commands

Workflow Example

Dependencies

Related skills

Frequently asked questions

How do I install the Pilot Blocklist skill?

What does the Pilot Blocklist skill do?

Is Pilot Blocklist safe to use?

Which AI agents work with Pilot Blocklist?

Is Pilot Blocklist free to use?

Who published Pilot Blocklist?