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.
- Version
- 3.1.0
- 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.
Pinned to revision 3831380a1276, so it is the text this page describes rather than whatever the author pushed since.
Pre-approved tools experimental
Experimental field. Support varies between clients, so this list is what the author declared, not what your client will enforce.
- Bash(python3:*)
- Bash(uv:*)
- Bash(dot:*)
- Read
- Write
Files
- skills/matrix-administration/SKILL.md
- skills/matrix-administration/LICENSE
- skills/matrix-administration/README.md
- skills/matrix-administration/evals/evals.json
- skills/matrix-administration/references/room-graph-pipeline.md
- skills/matrix-administration/references/room-health-checks.md
- skills/matrix-administration/references/safety-guide.md
- skills/matrix-administration/references/synapse-admin-api.md
- skills/matrix-administration/scripts/_lib/__init__.py
- skills/matrix-administration/scripts/_lib/admin_http.py
- skills/matrix-administration/scripts/_lib/colors.py
- skills/matrix-administration/scripts/_lib/condensing.py
- skills/matrix-administration/scripts/_lib/config.py
- skills/matrix-administration/scripts/_lib/pretty_bytes.py
- skills/matrix-administration/scripts/_lib/rating.py
- skills/matrix-administration/scripts/synapse-add-to-space.py
- skills/matrix-administration/scripts/synapse-biggest-rooms.py
- skills/matrix-administration/scripts/synapse-deactivate-user.py
- skills/matrix-administration/scripts/synapse-fetch-rooms.py
- skills/matrix-administration/scripts/synapse-graph.py
- skills/matrix-administration/scripts/synapse-join-room.py
- skills/matrix-administration/scripts/synapse-make-admin.py
- skills/matrix-administration/scripts/synapse-migrate-room.py
- skills/matrix-administration/scripts/synapse-rate-rooms.py
- skills/matrix-administration/scripts/synapse-room-member-flow.py
- skills/matrix-administration/scripts/synapse-search.py
- skills/matrix-administration/scripts/synapse-user-admin-rooms.py
- skills/matrix-administration/scripts/synapse-user-rooms.py
- skills/matrix-administration/scripts/test_migrate_room.py
Every link opens the file at its source, pinned to the revision this page describes.