SkillsAdd

netresearch/matrix-skill · Archived

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 operati…

First seen Apr 27, 2026

Installation

$ npx skills add netresearch/matrix-skill --skill matrix-administration
View on skills.sh ↗ GitHub repository ↗

Summary

  • 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.

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

matrix-communication Same source · more installs
netresearch/matrix-skill

Use when communicating via Matrix chat, notifying teams, or managing E2EE. Triggers on #room:se…

50 installs
matrix-announcement Same source
netresearch/matrix-skill

Use when composing a Matrix announcement — skill release, version bump, weekly digest, breaking…

13 installs
planetscale-best-practices-matrix Similar · more installs
planetscale/skills

A concise feature matrix for deciding which PlanetScale safety, observability, and automation r…

1.2K installs
ansoff-matrix Similar · more installs
phuryn/pm-skills

Generate an Ansoff Matrix analysis mapping growth strategies across market penetration, market …

2.4K installs

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

frontend-design Same topic
anthropics/skills

Guidance for distinctive, intentional visual design when building new UI or reshaping an existi…

866.4K installs
agent-browser Same topic
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
vercel-react-best-practices Same topic
vercel-labs/agent-skills 697.8K installs
web-design-guidelines Same topic
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs
microsoft-foundry Same topic
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-diagnostics Same topic
microsoft/azure-skills

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe …

568.9K installs

Also in this package

Other skills from netresearch/matrix-skill.

npx skills add netresearch/matrix-skill
matrix-communication 50 matrix-announcement 13

Browse all from netresearch/matrix-skill

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 5
License LICENSE-CC-BY-SA-4.0
Default branch main
Open issues 1
Status Archived

Skill metadata

Parsed from SKILL.md frontmatter.

Version3.1.3
License(MIT AND CC-BY-SA-4.0). See LICENSE-MIT and LICENSE-CC-BY-SA-4.0
Compatibilitypython3 (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.
Allowed toolsBash(uv run ${CLAUDE_SKILL_DIR}/scripts/*) Bash(python3 ${CLAUDE_SKILL_DIR}/scripts/*) Bash(python3 skills/matrix-administration/scripts/*) Bash(dot:*) Read Write
More metadata
author
Netresearch DTT GmbH
version
3.1.3
repository
https://github.com/netresearch/matrix-skill

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 5,153 B
  • docs SUMMARY.md 684 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 19 installs

SKILL.md

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 ${CLAUDE_SKILL_DIR}/scripts/synapse-fetch-rooms.py [--server :example.com]
python3 ${CLAUDE_SKILL_DIR}/scripts/synapse-rate-rooms.py --space '!home:srv' [--language de]
python3 ${CLAUDE_SKILL_DIR}/scripts/synapse-graph.py --space '!home:srv'
python3 ${CLAUDE_SKILL_DIR}/scripts/synapse-biggest-rooms.py [-n 10]

python3 ${CLAUDE_SKILL_DIR}/scripts/synapse-join-room.py    '!room:srv' '@user:srv'
python3 ${CLAUDE_SKILL_DIR}/scripts/synapse-make-admin.py   '!room:srv' '@user:srv'
python3 ${CLAUDE_SKILL_DIR}/scripts/synapse-add-to-space.py '!room:srv' '!space:srv'
python3 ${CLAUDE_SKILL_DIR}/scripts/synapse-migrate-room.py '!room:srv' '@admin:srv' '!space:srv'   # DESTRUCTIVE, asks first

python3 ${CLAUDE_SKILL_DIR}/scripts/synapse-deactivate-user.py   '@user:srv'   # DESTRUCTIVE
python3 ${CLAUDE_SKILL_DIR}/scripts/synapse-user-rooms.py        '@user:srv'
python3 ${CLAUDE_SKILL_DIR}/scripts/synapse-user-admin-rooms.py  '@user:srv'
python3 ${CLAUDE_SKILL_DIR}/scripts/synapse-room-member-flow.py  '!room:srv'
python3 ${CLAUDE_SKILL_DIR}/scripts/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 $XDGCONFIGHOME):

{
  "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 admintoken or accesstoken (server-admin) are required. The other fields are optional. Env fallbacks: MATRIXUSERID, MATRIXSPACEID, LANGUAGE=en|de, NO_COLOR.

Safety

The token is server-admin. Read [references/safety-guide.md](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

  • [references/synapse-admin-api.md](references/synapse-admin-api.md) — endpoints + upstream docs
  • [references/room-health-checks.md](references/room-health-checks.md) — rules + remediation
  • [references/room-graph-pipeline.md](references/room-graph-pipeline.md) — Docker dashboard recipe
  • [references/safety-guide.md](references/safety-guide.md) — destructive-op checklist
  • Source: netresearch/matrix-skill