block — drop a sender (--remove to re-allow, --list to audit)

SkillCommunication

Block a sender so their messages are dropped before decryption (and the relay is told to refuse their resends); re-allow one with `--remove`, or list blocked senders with `--list`. Use to stop unwanted or abusive mail from a specific sender, undo a block, or audit your block list. If the sender is not specified, ask with AskUserQuestion.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the block — drop a sender (--remove to re-allow, --list to audit) skill

What this skill tells your AI

The instructions your AI receives, as published by xhluca/agent-talk in skills/block/SKILL.md and read by ahel’s review.

retalk block <name-or-fingerprint> --dir "<user>/identity"            # block
retalk block --remove <name-or-fingerprint> --dir "<user>/identity"  # re-allow (unblock)
retalk block --list --json --dir "<user>/identity"                   # list blocked senders

Blocking drops a sender's incoming mail during receive before any decryption (so they can't consume a one-time key), and tells the relay to refuse their resends. Local to this identity. If no sender was named, use AskUserQuestion. Target the identity inline with --dir "<user>/identity".

  • --remove <name-or-fingerprint> re-allows a sender (a no-op if they aren't blocked).
  • --list --json prints the current block list (one {"fingerprint","name"} per line).

(agent-talk receives only from designated peers, so a blocked sender is already excluded from reads; block additionally tells the relay to refuse that sender's resends.)

<user> = this session's user directory — an absolute path resolved at init (e.g. ~/.agent-talk/users/alice (global) or <project>/.agent-talk/users/alice (local)). Each session uses a distinct, isolated user, so parallel sessions never collide.

Next

  • contacts — review saved peers.
  • receive — read remaining mail.

Signals

GitHub stars
184
Forks
14
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
block-xhluca
Source
github.com/xhluca/agent-talk