Skills

Matrix Server Management

Use for standalone Matrix admin requests (register users, create rooms, manage...

Install

npx skills add agentscope-ai/AgentTeams --skill matrix-server-management -g -a claude-code -y
Category
Engineering
Updated
3d ago
License
Apache-2.0
Context cost
Lightabout 266 tokens
Runs scripts
No, instructions only

What it does

Use for standalone Matrix admin requests (register users, create rooms, manage membership, upload files). Also use when you need to send a file to the admin via Matrix media upload. Do NOT use for Worker/project creation, those handle Matrix operations internally.

Matrix Server Management

Manage the Tuwunel Matrix Homeserver at ${AGENTTEAMS_MATRIX_URL}. User ID format: @<username>:${AGENTTEAMS_MATRIX_DOMAIN}.

Gotchas

  • Workers IGNORE messages without m.mentions, they have requireMention: true. You MUST include m.mentions.user_ids with the full Matrix user ID for Workers to process the message (MSC3952)
  • User IDs in body text and m.mentions.user_ids must match exactly, partial or mismatched IDs cause silent failures
  • trusted_private_chat only invites members, you must ensure each invited user accepts with POST /join; Controller-managed Worker and Team flows do this on the user's behalf
  • Matrix accounts cannot be deleted via API, reuse the same username on reset
  • Do NOT use this skill for Worker/project creation, create-worker.sh and create-project.sh handle Matrix operations internally

Operation Reference

SituationRead
Any Matrix API call (register, login, rooms, messages, mentions, file upload)references/api-reference.md

More in Engineering