Skill

matrix-communication

Use when communicating via Matrix chat, notifying teams, or managing E2EE. Triggers on #room:server references, Matrix URLs, and chat requests.

From matrix-communication

Install

Run in your terminal

npx claudepluginhub netresearch/claude-code-marketplace --plugin matrix-communication

Tool Access

This skill is limited to using the following tools:

Bash(python3:*) Bash(uv:*) Read Write

Supporting Assets

View in Repository

LICENSE

README.md

evals/evals.json

references/api-reference.md

references/e2ee-guide.md

references/messaging-guide.md

references/setup-guide.md

scripts/_lib/__init__.py

scripts/_lib/config.py

scripts/_lib/deps.py

scripts/_lib/e2ee.py

scripts/_lib/formatting.py

scripts/_lib/http.py

scripts/_lib/rooms.py

scripts/_lib/utils.py

scripts/matrix-doctor.py

scripts/matrix-e2ee-setup.py

scripts/matrix-e2ee-verify.py

scripts/matrix-edit-e2ee.py

scripts/matrix-edit.py

Skill Content

Similar Skills

agent-harness-construction

Designs and optimizes AI agent action spaces, tool definitions, observation formats, error recovery, and context for higher task completion rates.

everything-claude-code

139.9k

agent-payment-x402

Enables AI agents to execute x402 payments with per-task budgets, spending controls, and non-custodial wallets via MCP tools. Use when agents pay for APIs, services, or other agents.

everything-claude-code

139.9k

agent-eval

Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.

everything-claude-code

139.9k

Stats

Stars2

Forks0

Last CommitApr 2, 2026

Actions

View Source View Plugin View on GitHub View README

Matrix Communication

Send and read messages in Matrix rooms. Always use *-e2ee.py scripts.

Bash ! rule: Prepend set +H && when arguments contain !

Quick Reference

ROOM: name (test), ID (!abc:server), or alias (#room:server).

# Send (E2EE)
set +H && uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-send-e2ee.py ROOM "message"
uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-send-e2ee.py ROOM "message" --no-prefix
uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-send-e2ee.py ROOM "is deploying" --emote
uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-send-e2ee.py ROOM "reply" --thread '$rootEventId'
uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-send-e2ee.py ROOM "reply" --reply '$eventId'

# Read (E2EE)
uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-read-e2ee.py ROOM --limit 10
uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-read-e2ee.py ROOM --limit 20 --json
uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-read-e2ee.py ROOM --limit 10 --request-keys

# Edit / Delete / React
uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-edit-e2ee.py ROOM '$eventId' "new text"
uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-redact.py ROOM '$eventId' "reason"
uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-react.py ROOM '$eventId' "✅"

# Rooms
uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-rooms.py
uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-rooms.py --search ops
uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-resolve.py "#room:server"

# E2EE management
uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-e2ee-setup.py --status
MATRIX_PASSWORD="pass" uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-e2ee-setup.py
uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-e2ee-verify.py --timeout 180
uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-fetch-keys.py ROOM --sync-time 60
uv run ${CLAUDE_SKILL_DIR}/scripts/matrix-key-backup.py --recovery-key "EsTj ..." --import-keys

# Health check (uses python3, not uv run)
python3 ${CLAUDE_SKILL_DIR}/scripts/matrix-doctor.py --install

Script Selection

Operation	E2EE (preferred)	Non-E2EE Fallback
Send	`matrix-send-e2ee.py`	`matrix-send.py`
Read	`matrix-read-e2ee.py`	`matrix-read.py`
Edit	`matrix-edit-e2ee.py`	`matrix-edit.py`
React	`matrix-react.py`	(same)
Delete	`matrix-redact.py`	(same)

Other: matrix-rooms.py, matrix-resolve.py, matrix-e2ee-setup.py, matrix-e2ee-verify.py, matrix-fetch-keys.py, matrix-key-backup.py, matrix-doctor.py.

Config

~/.config/matrix/config.json — required: homeserver, user_id. Optional: access_token, bot_prefix

Error Handling

Error	Solution
`M_FORBIDDEN`	Join room first in Element
`M_UNKNOWN_TOKEN`	Get new token from Element
`M_LIMIT_EXCEEDED`	Wait and retry
`Could not find room`	`matrix-rooms.py` to list rooms
`[Unable to decrypt]`	`matrix-key-backup.py --recovery-key "..." --import-keys`
`libolm not found`	`apt install libolm-dev` / `brew install libolm`
`matrix-nio not found`	`python3 ${CLAUDE_SKILL_DIR}/scripts/matrix-doctor.py --install`
`Invalid password`	Use env var: `MATRIX_PASSWORD="pass" uv run ...`
`signature failed`	Dedicated device via `matrix-e2ee-setup.py`

Common Mistakes

Using non-E2EE scripts for encrypted rooms — always default to *-e2ee.py
Forgetting set +H — ! in messages/passwords gets mangled by bash
Skipping --import-keys — key backup shows but doesn't save keys without it
Using Element X for verification — use Element Desktop or Android
Not running matrix-doctor.py --install first — dependency errors
Hardcoding passwords — use MATRIX_PASSWORD env var for special characters

References

references/setup-guide.md — setup walkthrough
references/e2ee-guide.md — E2EE, key recovery, verification
references/messaging-guide.md — formatting, reactions, patterns
references/api-reference.md — Matrix API endpoints
netresearch/matrix-skill