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-add-to-space.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 = []
# ///
"""Link a room into a space.
Sends an ``m.space.child`` state event on the space with the room as the
state key. The admin token must belong to a user that has permission to
send state events in the space (typically a space admin).
Usage:
synapse-add-to-space.py <ROOM_ID> [SPACE_ID]
Falls back to ``$MATRIX_SPACE_ID`` and then to ``default_space_id`` from
the config when ``SPACE_ID`` is omitted.
"""
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 client_request, load_config, quote
def main() -> int:
parser = argparse.ArgumentParser(description=__doc__.split("\n\n")[0])
parser.add_argument("room_id")
parser.add_argument("space_id", nargs="?", default=None)
parser.add_argument(
"--via",
action="append",
default=None,
help="Server name to include in 'via'. Repeatable; defaults to the "
"homeserver hostname.",
)
parser.add_argument("--suggested", action="store_true")
args = parser.parse_args()
config = load_config()
space_id = (
args.space_id
or os.environ.get("MATRIX_SPACE_ID")
or config.get("default_space_id")
)
if not space_id:
print(
"Error: SPACE_ID required (positional, $MATRIX_SPACE_ID, or "
"'default_space_id' in config).",
file=sys.stderr,
)
return 2
via = args.via
if not via:
from urllib.parse import urlparse
host = urlparse(config["homeserver"]).hostname
via = [host] if host else []
body = {"via": via, "suggested": args.suggested}
endpoint = f"/rooms/{quote(space_id)}/state/m.space.child/{quote(args.room_id)}"
result = client_request(config, "PUT", endpoint, body)
print(json.dumps(result, indent=2))
return 0 if "error" not in result else 1
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 |