netresearch/matrix-skill / skills/matrix-administration
matrix-administration
VerifiedUse 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.
scripts/synapse-rate-rooms.py
View on GitHub#!/usr/bin/env -S uv run --script
# SPDX-License-Identifier: MIT
# SPDX-FileCopyrightText: Netresearch DTT GmbH
# /// script
# requires-python = ">=3.11"
# dependencies = []
# ///
"""Rate every room in a snapshot and print the failing ones.
Reads ``rooms.json`` (produced by ``synapse-fetch-rooms.py``), runs the
health-check rules from ``_lib/rating.py`` against every non-replaced room,
and prints two formatted lists of rooms with at least one ``FAIL`` finding:
1. Jira wiki markup
2. Markdown
Use ``--language de`` for German phrasing. Pass ``--space`` one or more
times (or set ``default_space_id``/``home_space_ids`` in the config) to
enable the "is in one of our spaces" checks; without it those checks are
skipped.
Usage:
synapse-rate-rooms.py [--input rooms.json] [--language en|de] \\
[--space '!ID:server' …]
"""
from __future__ import annotations
import argparse
import json
import os
import sys
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
from _lib import (
RoomRating,
condense,
format_rating,
load_config,
rate_room,
)
def main() -> int:
parser = argparse.ArgumentParser(description=__doc__.split("\n\n")[0])
parser.add_argument("-i", "--input", default="rooms.json")
parser.add_argument("-l", "--language", default=None, choices=["en", "de"])
parser.add_argument(
"-s",
"--space",
action="append",
default=None,
help="Space ID treated as 'home'. Repeatable.",
)
args = parser.parse_args()
config = load_config(require_admin=False)
language = args.language or os.environ.get("LANGUAGE", "en")
if language not in ("en", "de"):
language = "en"
home_spaces: list[str] = list(args.space or [])
if not home_spaces:
cfg_home = config.get("home_space_ids") or []
if isinstance(cfg_home, list):
home_spaces.extend(cfg_home)
if config.get("default_space_id"):
home_spaces.append(config["default_space_id"])
with open(args.input) as f:
data = json.load(f)
rooms = condense(data)
flagged = []
for r in rooms.values():
if r.is_replaced:
continue
_overall, messages = rate_room(r, rooms, home_spaces, language)
ratings = [m for m in messages if m[0] != RoomRating.SUCCESS]
if any(rating == RoomRating.FAIL for rating, _ in ratings):
flagged.append((r, ratings))
flagged.sort(key=lambda pair: pair[0].name.strip().lower())
def render(formatter):
return "\n".join(formatter(r, ratings) for r, ratings in flagged)
def jira(r, ratings):
head = f"{{task}}{r.name.strip()} (v{r.version}){{task}}"
body = "\n".join(f"** {format_rating(m)}" for m in ratings)
return f"{head}\n{body}" if body else head
def markdown(r, ratings):
head = f"- {r.name.strip()} (v{r.version})"
body = "\n".join(f" {format_rating(m)}" for m in ratings)
return f"{head}\n{body}" if body else head
print(render(jira))
print("\n\n")
print(render(markdown))
return 0
if __name__ == "__main__":
sys.exit(main())
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |