Skills

Channel Management

Use when determining sender identity in any room, managing trusted contacts...

Install

npx skills add agentscope-ai/AgentTeams --skill channel-management -g -a claude-code -y
Category
Engineering
Updated
3d ago
License
Apache-2.0
Context cost
Lightabout 448 tokens
Runs scripts
Yes, review before use

What it does

Use when determining sender identity in any room, managing trusted contacts, configuring the admin's primary notification channel, handling first-contact from a new channel, or escalating to admin across channels.

Channel Management

Manages communication channels, admin identity recognition, trusted contacts, and primary channel configuration.

Gotchas

  • Primary channel cannot be set to "matrix", Matrix DM is the default fallback. Use --action reset to revert to it
  • Unknown senders in group rooms must be silently ignored, no response at all, until admin explicitly approves them as trusted contacts
  • Trusted contacts must never receive sensitive info, no API keys, tokens, passwords, Worker credentials, or internal config. No management operations either
  • When calling message tool from a Matrix session, you MUST explicitly set channel and target, otherwise the message goes to the current Matrix room instead of the primary channel
  • to field in primary-channel.json maps to target parameter in message tool, pass the value directly, no transformation needed
  • First-contact protocol: always ask in admin's language, match the language they used in their message
  • Task dispatch must go to Worker Room, not admin DM, when assigning tasks to Workers, use the task-management skill's send protocol (runtime-aware: agt get managers -o json for runtime, then message tool or copaw channels send per finite/infinite references). Never embed @worker task assignments in admin DM replies.

Operation Reference

Read the relevant doc before executing. Do not load all of them.

SituationRead
Need to identify who sent a message (admin, worker, trusted contact, unknown)references/identity-and-contacts.md
Add/remove trusted contactsreferences/identity-and-contacts.md
Configure primary channel, send notifications, first-contact protocol, cross-channel escalationreferences/primary-channel.md

More in Engineering