netresearch/matrix-skill / skills/matrix-communication
matrix-communication
FlaggedUse when communicating via Matrix chat, notifying teams, or managing E2EE. Triggers on #room:server references, Matrix URLs, and chat requests.
README.md
View on GitHub<!-- 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/)**
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |