Skip to content

netresearch/matrix-skill / skills/matrix-communication

matrix-communication

Flagged

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

FileKindSize
README.mdmarkdown2.9 KB
SKILL.mdskill md6.7 KB
evals/evals.jsonconfig12.6 KB
references/agent-governance.mdmarkdown2.0 KB
references/api-reference.mdmarkdown7.3 KB
references/command-reference.mdmarkdown8.9 KB
references/e2ee-guide.mdmarkdown17.2 KB
references/hookshot-integration.mdmarkdown10.7 KB
references/messaging-guide.mdmarkdown13.8 KB
references/no-editorializing.mdmarkdown331 B
references/setup-guide.mdmarkdown11.1 KB
references/troubleshooting.mdmarkdown7.8 KB
scripts/_lib/__init__.pyscript3.6 KB
scripts/_lib/backup_mac.pyscript1.2 KB
scripts/_lib/config.pyscript4.6 KB
scripts/_lib/daemon_client.pyscript3.0 KB
scripts/_lib/deps.pyscript1.9 KB
scripts/_lib/downloads.pyscript1.1 KB
scripts/_lib/e2ee.pyscript13.2 KB
scripts/_lib/formatting.pyscript14.4 KB
scripts/_lib/http.pyscript4.8 KB
scripts/_lib/reactions.pyscript2.9 KB
scripts/_lib/roomlog.pyscript13.7 KB
scripts/_lib/rooms.pyscript15.5 KB
scripts/_lib/secret_input.pyscript2.0 KB
scripts/_lib/test_backup_mac.pyscript1.5 KB
scripts/_lib/test_config.pyscript7.1 KB
scripts/_lib/test_daemon_client.pyscript5.9 KB
scripts/_lib/test_downloads.pyscript2.3 KB
scripts/_lib/test_e2ee.pyscript14.3 KB
scripts/_lib/test_formatting.pyscript15.5 KB
scripts/_lib/test_http.pyscript4.1 KB
scripts/_lib/test_reactions.pyscript15.2 KB
scripts/_lib/test_roomlog.pyscript20.2 KB
scripts/_lib/test_rooms.pyscript13.7 KB
scripts/_lib/test_secret_input.pyscript2.2 KB
scripts/_lib/test_trust.pyscript8.3 KB
scripts/_lib/trust.pyscript5.3 KB
scripts/_lib/utils.pyscript1.7 KB
scripts/matrix-create-room.pyexecutablescript4.7 KB
scripts/matrix-doctor.pyexecutablescript22.2 KB
scripts/matrix-download-e2ee.pyexecutablescript7.7 KB
scripts/matrix-e2ee-setup.pyexecutablescript9.2 KB
scripts/matrix-e2ee-verify.pyexecutablescript29.2 KB
scripts/matrix-edit-e2ee.pyexecutablescript7.9 KB
scripts/matrix-edit.pyexecutablescript5.3 KB
scripts/matrix-fetch-keys.pyexecutablescript9.1 KB
scripts/matrix-invite.pyexecutablescript3.0 KB
scripts/matrix-key-backup.pyexecutablescript21.3 KB
scripts/matrix-power-level.pyexecutablescript7.0 KB
scripts/matrix-react.pyexecutablescript14.1 KB
scripts/matrix-read-e2ee.pyexecutablescript12.8 KB
scripts/matrix-read.pyexecutablescript4.7 KB
scripts/matrix-redact.pyexecutablescript5.0 KB
scripts/matrix-resolve.pyexecutablescript1.7 KB
scripts/matrix-rooms.pyexecutablescript3.8 KB
scripts/matrix-send-e2ee.pyexecutablescript19.4 KB
scripts/matrix-send.pyexecutablescript9.4 KB
scripts/matrix-watch.pyexecutablescript5.3 KB
scripts/matrix-watchd.pyexecutablescript23.5 KB
scripts/test_matrix_doctor.pyscript14.2 KB
scripts/test_matrix_read_e2ee.pyscript2.7 KB

scripts/matrix-create-room.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 = []
# ///
"""Create a new Matrix room.

Usage:
    matrix-create-room.py NAME [OPTIONS]
    matrix-create-room.py --help

Arguments:
    NAME        Room display name

Options:
    --alias LOCALPART   Room alias localpart, e.g. "lsb" -> #lsb:server
                        (fails if the alias is already taken)
    --topic TOPIC       Room topic
    --invite USER_ID    Invite a user on creation (repeatable)
    --preset PRESET     private_chat (default) | public_chat | trusted_private_chat
    --json              Output as JSON
    --quiet             Minimal output (just the room ID)
    --debug             Show debug information

Examples:
    # Minimal private room
    matrix-create-room.py "LSB Project"

    # With alias and initial invites
    matrix-create-room.py "LSB Project" --alias lsb \\
        --invite '@tobias.hein:netresearch.de' --invite '@jane.doe:netresearch.de'

    # Public room with topic
    matrix-create-room.py "LSB Project" --topic "Landessportbund onboarding" \\
        --preset public_chat
"""

import json
import os
import sys

# Add script directory to path for _lib imports
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))

from _lib import load_config, matrix_request

sys.stdout.reconfigure(line_buffering=True)
sys.stderr.reconfigure(line_buffering=True)


def create_room(
    config: dict,
    name: str,
    alias: str | None = None,
    topic: str | None = None,
    invite: list[str] | None = None,
    preset: str = "private_chat",
) -> dict:
    """Create a Matrix room.

    Args:
        config: Matrix config with homeserver and access_token
        name: Room display name
        alias: Room alias localpart (without # or :server)
        topic: Room topic
        invite: List of user IDs to invite on creation
        preset: Room preset (private_chat, public_chat, trusted_private_chat)

    Returns:
        Response dict with 'room_id' on success, or 'error' on failure
    """
    content = {"name": name, "preset": preset}
    if alias:
        content["room_alias_name"] = alias
    if topic:
        content["topic"] = topic
    if invite:
        content["invite"] = invite

    return matrix_request(config, "POST", "/createRoom", content)


def main():
    import argparse

    parser = argparse.ArgumentParser(description="Create a new Matrix room")
    parser.add_argument("name", help="Room display name")
    parser.add_argument(
        "--alias", metavar="LOCALPART", help="Room alias localpart (e.g. 'lsb')"
    )
    parser.add_argument("--topic", help="Room topic")
    parser.add_argument(
        "--invite",
        metavar="USER_ID",
        action="append",
        help="Invite a user on creation (repeatable)",
    )
    parser.add_argument(
        "--preset",
        choices=["private_chat", "public_chat", "trusted_private_chat"],
        default="private_chat",
        help="Room preset (default: private_chat)",
    )
    parser.add_argument("--json", action="store_true", help="Output as JSON")
    parser.add_argument("--quiet", "-q", action="store_true", help="Minimal output")
    parser.add_argument("--debug", action="store_true", help="Show debug info")

    args = parser.parse_args()

    config = load_config()

    if args.debug:
        print(
            f"Creating room name={args.name!r} alias={args.alias!r} "
            f"preset={args.preset} invite={args.invite}",
            file=sys.stderr,
        )

    result = create_room(
        config,
        args.name,
        alias=args.alias,
        topic=args.topic,
        invite=args.invite,
        preset=args.preset,
    )

    if "error" in result:
        if args.json:
            print(json.dumps(result))
        else:
            print(f"Error: {result['error']}", file=sys.stderr)
        sys.exit(1)

    if args.json:
        print(json.dumps(result))
    elif args.quiet:
        print(result.get("room_id", ""))
    else:
        print(f"Room created: {result.get('room_id')}")
        if args.alias:
            # Room aliases live on the user's server_name (from user_id),
            # not the homeserver URL — these differ when the homeserver is
            # reached via a delegated/well-known domain (e.g. homeserver
            # https://matrix.example.com but server_name example.com).
            user_id = config.get("user_id")
            if not user_id:
                whoami = matrix_request(config, "GET", "/account/whoami")
                user_id = whoami.get("user_id")
            if user_id:
                server_name = user_id.split(":", 1)[-1]
                print(f"Alias: #{args.alias}:{server_name}")


if __name__ == "__main__":
    main()
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 197kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall