matrix-administration

Use when administering a Synapse / Matrix homeserver — list or snapshot all rooms, rate room health (public, unencrypted, orphaned), render a Graphviz map of the room/space tree, force-join users, promote room admins, harden rooms (add-to-space + restrict + encrypt), deactivate Matrix users (with GDPR erase), find biggest rooms by DB size, audit where a user is admin or member, replay join/leave timelines, or search unencrypted history. Trigger on any '/_synapse/admin', server-wide room operation, Matrix user offboarding, or anything requiring a homeserver-admin token — even without 'admin API' in the prompt. Companion to matrix-communication.

Jump to install

Repository: netresearch/matrix-skill
Last source activity: August 17, 2026 at 07:57
Detected SKILL.md language: English
Stars: 4
Forks: 0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/netresearch/matrix-skill --skill matrix-administration

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

29 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

matrix-announcement

Use when composing a Matrix announcement — skill release, version bump, weekly digest, breaking-change heads-up, postmortem, RFC, multi-skill pipeline summary, or any agent-authored room post longer than a single line. Trigger before any matrix-send call that produces structured content. Companion to matrix-communication.

2026-08-17

matrix-communication

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

2026-08-17

View all from this repository

Matrix Administration

Stdlib-only Python wrappers around the Synapse Admin API and the Client-Server API. Reads ~/.config/matrix/config.json (the same file matrix-communication uses).

Quick Reference

S=skills/matrix-administration/scripts python3 $S/synapse-fetch-rooms.py [--server :example.com] python3 $S/synapse-rate-rooms.py --space '!home:srv' [--language de] python3 $S/synapse-graph.py --space '!home:srv' python3 $S/synapse-biggest-rooms.py [-n 10] python3 $S/synapse-join-room.py '!room:srv' '@user:srv' python3 $S/synapse-make-admin.py '!room:srv' '@user:srv' python3 $S/synapse-add-to-space.py '!room:srv' '!space:srv' python3 $S/synapse-migrate-room.py '!room:srv' '@admin:srv' '!space:srv' # DESTRUCTIVE, asks first python3 $S/synapse-deactivate-user.py '@user:srv' # DESTRUCTIVE python3 $S/synapse-user-rooms.py '@user:srv' python3 $S/synapse-user-admin-rooms.py '@user:srv' python3 $S/synapse-room-member-flow.py '!room:srv' python3 $S/synapse-search.py '!room:srv' '@bot:srv' deploy

Scripts

Script

Purpose

synapse-fetch-rooms.py

Snapshot all rooms + state → rooms.json

synapse-rate-rooms.py

Health checks (EN/DE) on rooms.json

synapse-graph.py

Render rooms.json → Graphviz .dot + .svg

synapse-biggest-rooms.py

Top-N rooms by DB size

synapse-join-room.py

Force-join a user

synapse-make-admin.py

Promote to PL 100

synapse-add-to-space.py

Send m.space.child

synapse-migrate-room.py

Add to space + restrict + encrypt

synapse-deactivate-user.py

Destructive deactivation (--erase for GDPR)

synapse-user-admin-rooms.py

Local: rooms where user is PL 100

synapse-user-rooms.py

Local: rooms a user belongs to

synapse-room-member-flow.py

Join/leave timeline

synapse-search.py

Unencrypted history search

Setup

~/.config/matrix/config.json (respects $XDG_CONFIG_HOME):

{ "homeserver": "https://matrix.example.com", "admin_token": "syt_admin_…", "room_filter": ":example.com", "default_space_id": "!home:example.com", "home_space_ids": ["!home:example.com"] }

homeserver and either admin_token or access_token (server-admin) are required. The other fields are optional. Env fallbacks: MATRIX_USER_ID, MATRIX_SPACE_ID, LANGUAGE=en|de, NO_COLOR.

Safety

The token is server-admin. Read references/safety-guide.md before any destructive op.

synapse-deactivate-user.py is irreversible.

synapse-migrate-room.py enables encryption (one-way) and restricts joins; it prints the plan and asks before the first write (--yes skips, and is required without a terminal). Power-level changes restored on exit including Ctrl-C.

synapse-make-admin.py raises PL 100 permanently.

synapse-search.py cannot read E2EE — empty ≠ no messages.

rooms.json exposes user IDs; never commit it.

References

name	matrix-administration
description	Use when administering a Synapse / Matrix homeserver — list or snapshot all rooms, rate room health (public, unencrypted, orphaned), render a Graphviz map of the room/space tree, force-join users, promote room admins, harden rooms (add-to-space + restrict + encrypt), deactivate Matrix users (with GDPR erase), find biggest rooms by DB size, audit where a user is admin or member, replay join/leave timelines, or search unencrypted history. Trigger on any '/_synapse/admin', server-wide room operation, Matrix user offboarding, or anything requiring a homeserver-admin token — even without 'admin API' in the prompt. Companion to matrix-communication.
license	(MIT AND CC-BY-SA-4.0). See LICENSE-MIT and LICENSE-CC-BY-SA-4.0
compatibility	python3 (stdlib only) + a Matrix access token belonging to a Synapse server-admin user. Optional: graphviz `dot` for SVG. Synapse 1.x with admin API enabled.
metadata	{"author":"Netresearch DTT GmbH","version":"3.1.1","repository":"https://github.com/netresearch/matrix-skill"}
allowed-tools	Bash(python3:) Bash(uv:) Bash(dot:*) Read Write

name	matrix-administration
description	Use when administering a Synapse / Matrix homeserver — list or snapshot all rooms, rate room health (public, unencrypted, orphaned), render a Graphviz map of the room/space tree, force-join users, promote room admins, harden rooms (add-to-space + restrict + encrypt), deactivate Matrix users (with GDPR erase), find biggest rooms by DB size, audit where a user is admin or member, replay join/leave timelines, or search unencrypted history. Trigger on any '/_synapse/admin', server-wide room operation, Matrix user offboarding, or anything requiring a homeserver-admin token — even without 'admin API' in the prompt. Companion to matrix-communication.
license	(MIT AND CC-BY-SA-4.0). See LICENSE-MIT and LICENSE-CC-BY-SA-4.0
compatibility	python3 (stdlib only) + a Matrix access token belonging to a Synapse server-admin user. Optional: graphviz `dot` for SVG. Synapse 1.x with admin API enabled.
metadata	{"author":"Netresearch DTT GmbH","version":"3.1.1","repository":"https://github.com/netresearch/matrix-skill"}
allowed-tools	Bash(python3:) Bash(uv:) Bash(dot:*) Read Write

matrix-administration

Source facts

Install options

Review the source files

More from this repository

More from this repository