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.mdmarkdown13.8 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-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 = []
# ///
"""List joined Matrix rooms.

Usage:
    matrix-rooms.py [--json] [--search TERM]
    matrix-rooms.py --lookup NAME
    matrix-rooms.py --help

Options:
    --json            Output as JSON
    --search TERM     Filter rooms by name or alias; a room without a name
                      (a direct chat) is named after its members and also
                      matches on their user IDs
    --lookup NAME     Find room by name and output room ID (for scripts)
    --help            Show this help

Examples:
    # List all rooms with names, aliases, and IDs
    matrix-rooms.py

    # Search for rooms containing "agent"
    matrix-rooms.py --search agent

    # Find the direct chat with Jane Doe (by display name or user ID)
    matrix-rooms.py --lookup "Jane Doe"
    matrix-rooms.py --search @jane:example.org

    # Get room ID by name (for use in other commands)
    matrix-rooms.py --lookup "agent-work"

    # Use in pipeline
    matrix-send.py "$(matrix-rooms.py --lookup agent-work)" "Hello!"
"""

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 find_room_by_name, list_joined_rooms, load_config, room_matches

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


def main():
    import argparse

    parser = argparse.ArgumentParser(description="List joined Matrix rooms")
    parser.add_argument("--json", action="store_true", help="Output as JSON")
    parser.add_argument(
        "--search", "-s", help="Filter rooms by name, alias or member user ID"
    )
    parser.add_argument(
        "--lookup",
        "-l",
        metavar="NAME",
        help="Find room by name and output room ID (for scripts)",
    )

    args = parser.parse_args()

    config = load_config()

    # Lookup mode: find a specific room and print its ID
    if args.lookup:
        room_id, matches = find_room_by_name(config, args.lookup)
        if room_id:
            if args.json:
                # Find the full room info from matches
                room_info = matches[0] if matches else {"room_id": room_id}
                print(json.dumps(room_info, indent=2))
            else:
                print(room_id)
            return
        else:
            # Check if it's an ambiguous match
            if matches:
                print(
                    f"Error: Ambiguous match for '{args.lookup}'. Found {len(matches)} rooms:",
                    file=sys.stderr,
                )
                for m in matches:
                    alias_str = f" ({m['alias']})" if m.get("alias") else ""
                    print(
                        f"  - {m['name']}{alias_str}: {m['room_id']}", file=sys.stderr
                    )
            else:
                print(f"Error: No room found matching '{args.lookup}'", file=sys.stderr)
            sys.exit(1)

    rooms = list_joined_rooms(config)
    rooms = sorted(rooms, key=lambda r: r["name"].lower())

    if args.search:
        rooms = [r for r in rooms if room_matches(r, args.search.lower())]

    if args.json:
        print(json.dumps(rooms, indent=2))
    else:
        if not rooms:
            print("No rooms found")
            return

        print(f"{'Room Name':<40} {'Alias':<35} {'Room ID'}")
        print("-" * 120)
        for room in rooms:
            name = room["name"][:38] if len(room["name"]) > 38 else room["name"]
            alias = room.get("alias") or ""
            alias = alias[:33] if len(alias) > 33 else alias
            print(f"{name:<40} {alias:<35} {room['room_id']}")


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: 198kUpdated 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