Skip to content

netresearch/matrix-skill / skills/matrix-communication

matrix-communication

Flagged

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

FileKindSize
README.mdmarkdown2.9 KB
SKILL.mdskill md6.7 KB
evals/evals.jsonconfig12.6 KB
references/agent-governance.mdmarkdown2.0 KB
references/api-reference.mdmarkdown7.3 KB
references/command-reference.mdmarkdown8.9 KB
references/e2ee-guide.mdmarkdown17.2 KB
references/hookshot-integration.mdmarkdown10.7 KB
references/messaging-guide.mdmarkdown13.8 KB
references/no-editorializing.mdmarkdown331 B
references/setup-guide.mdmarkdown13.8 KB
references/troubleshooting.mdmarkdown7.8 KB
scripts/_lib/__init__.pyscript3.6 KB
scripts/_lib/backup_mac.pyscript1.2 KB
scripts/_lib/config.pyscript4.6 KB
scripts/_lib/daemon_client.pyscript3.0 KB
scripts/_lib/deps.pyscript1.9 KB
scripts/_lib/downloads.pyscript1.1 KB
scripts/_lib/e2ee.pyscript13.2 KB
scripts/_lib/formatting.pyscript14.4 KB
scripts/_lib/http.pyscript4.8 KB
scripts/_lib/reactions.pyscript2.9 KB
scripts/_lib/roomlog.pyscript13.7 KB
scripts/_lib/rooms.pyscript15.5 KB
scripts/_lib/secret_input.pyscript2.0 KB
scripts/_lib/test_backup_mac.pyscript1.5 KB
scripts/_lib/test_config.pyscript7.1 KB
scripts/_lib/test_daemon_client.pyscript5.9 KB
scripts/_lib/test_downloads.pyscript2.3 KB
scripts/_lib/test_e2ee.pyscript14.3 KB
scripts/_lib/test_formatting.pyscript15.5 KB
scripts/_lib/test_http.pyscript4.1 KB
scripts/_lib/test_reactions.pyscript15.2 KB
scripts/_lib/test_roomlog.pyscript20.2 KB
scripts/_lib/test_rooms.pyscript13.7 KB
scripts/_lib/test_secret_input.pyscript2.2 KB
scripts/_lib/test_trust.pyscript8.3 KB
scripts/_lib/trust.pyscript5.3 KB
scripts/_lib/utils.pyscript1.7 KB
scripts/matrix-create-room.pyexecutablescript4.7 KB
scripts/matrix-doctor.pyexecutablescript22.2 KB
scripts/matrix-download-e2ee.pyexecutablescript7.7 KB
scripts/matrix-e2ee-setup.pyexecutablescript9.2 KB
scripts/matrix-e2ee-verify.pyexecutablescript29.2 KB
scripts/matrix-edit-e2ee.pyexecutablescript7.9 KB
scripts/matrix-edit.pyexecutablescript5.3 KB
scripts/matrix-fetch-keys.pyexecutablescript9.1 KB
scripts/matrix-invite.pyexecutablescript3.0 KB
scripts/matrix-key-backup.pyexecutablescript21.3 KB
scripts/matrix-power-level.pyexecutablescript7.0 KB
scripts/matrix-react.pyexecutablescript14.1 KB
scripts/matrix-read-e2ee.pyexecutablescript12.8 KB
scripts/matrix-read.pyexecutablescript4.7 KB
scripts/matrix-redact.pyexecutablescript5.0 KB
scripts/matrix-resolve.pyexecutablescript1.7 KB
scripts/matrix-rooms.pyexecutablescript3.8 KB
scripts/matrix-send-e2ee.pyexecutablescript19.4 KB
scripts/matrix-send.pyexecutablescript9.4 KB
scripts/matrix-watch.pyexecutablescript5.3 KB
scripts/matrix-watchd.pyexecutablescript23.5 KB
scripts/test_matrix_doctor.pyscript14.2 KB
scripts/test_matrix_read_e2ee.pyscript2.7 KB
<!-- SPDX-License-Identifier: CC-BY-SA-4.0 -->
<!-- SPDX-FileCopyrightText: Netresearch DTT GmbH -->

# Matrix Communication

Send and receive messages in Matrix chat rooms with full E2EE encryption support.

## Features

- **E2EE Encryption** - Full end-to-end encryption support
- **Send Messages** - Post to any joined room with markdown formatting
- **Read Messages** - Decrypt and read encrypted messages
- **Live Awareness** - A daemon follows rooms and appends every event to a log the agent tails while it works
- **Mentions** - `--mention` sets `m.mentions`, so the notification actually reaches the person
- **Edit Messages** - Modify existing messages
- **Reactions** - Add emoji reactions (āœ… šŸ‘ šŸš€)
- **Redact** - Delete messages
- **Download Media** - Decrypt and save images, files, video and audio
- **Room Management** - Create rooms, invite users, manage power levels
- **Bot Prefix** - Optional šŸ¤– prefix for automated messages

## Installation

### Option 1: Via Netresearch Marketplace (Recommended)

```bash
/plugin marketplace add netresearch/claude-code-marketplace
```

Then install with `/install-plugin netresearch/matrix-skill`

### Option 2: Download Release

Download the [latest release](https://github.com/netresearch/matrix-skill/releases/latest) and extract to `~/.claude/skills/matrix-communication/`

## Usage

The skill triggers automatically on:
- Room references: `#room:server`, `!roomid:server`
- Chat requests: "send to matrix", "post in chat"
- Matrix URLs: `https://matrix.*/`, `https://element.*/`

### Setup

Just ask:
> "Set up the Matrix skill for me"

The agent guides you through homeserver, user ID, and E2EE device creation.

### Example Prompts

```
"Send 'Deployment complete!' to #ops:matrix.org"
"Read the last 10 messages from #dev:matrix.org"
"React with āœ… to the last message in #support"
"Follow #ops:matrix.org while you work on this"
```

## Structure

```
matrix-communication/
ā”œā”€ā”€ SKILL.md              # AI instructions
ā”œā”€ā”€ README.md             # This file
ā”œā”€ā”€ scripts/              # All Matrix scripts
│   ā”œā”€ā”€ matrix-send-e2ee.py
│   ā”œā”€ā”€ matrix-read-e2ee.py
│   ā”œā”€ā”€ matrix-edit-e2ee.py
│   └── ...
└── references/
    └── api-reference.md
```

## References

- `references/setup-guide.md` - setup
- `references/e2ee-guide.md` - E2EE, key recovery, verification
- `references/messaging-guide.md` - formatting, reactions
- `references/api-reference.md` - Matrix API endpoints
- `references/hookshot-integration.md` - provisioning webhooks via the matrix-hookshot bridge bot
- `references/no-editorializing.md` - writing without self-praise

## License

MIT AND CC-BY-SA-4.0 — see [LICENSE-MIT](../../LICENSE-MIT) and
[LICENSE-CC-BY-SA-4.0](../../LICENSE-CC-BY-SA-4.0).

## Credits

Developed and maintained by [Netresearch DTT GmbH](https://www.netresearch.de/).

---

**Made with ā¤ļø for Open Source by [Netresearch](https://www.netresearch.de/)**
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall