team-communication-protocols

Overview

What is team-communication-protocols?

team-communication-protocols is a project-management skill designed to help agent teams establish clear and effective communication workflows. It provides structured protocols for selecting message types, managing plan approvals, orchestrating team shutdowns, and avoiding common communication anti-patterns. This skill is especially useful for teams using platforms like Slack or Discord, or for any agent-based collaboration where clarity and coordination are essential.

Who should use this skill?

• Teams forming new agent-based projects and needing to define communication standards
• Project managers or team leads seeking to streamline plan approvals and task coordination
• Developers troubleshooting integration or coordination issues between teammates
• Anyone managing agent teams on platforms such as Slack, Discord, or GitHub

Problems it solves

• Confusion over when to use direct messages versus broadcasts
• Lack of clarity in plan approval and task assignment workflows
• Inefficient or incomplete team shutdown procedures
• Common communication anti-patterns that hinder collaboration

How to Use

Installation Steps

1. Install the skill using the following command:

   npx skills add https://github.com/wshobson/agents --skill team-communication-protocols
   

2. Start by reviewing the SKILL.md file for an overview of the communication protocols and recommended workflows.

3. Explore the references/messaging-patterns.md file for ready-to-use message templates covering task assignments, integration notifications, blocker reports, and more.

4. Check the references/ folder for additional context and supporting documentation.

Adapting the Skill

• Tailor the provided messaging patterns and workflows to fit your team's specific tools and operational needs.
• Use the message type selection guidance to decide when to send a direct message (message) or a broadcast (broadcast).
• Implement plan approval and shutdown procedures as outlined to ensure smooth project progression and completion.

Key Files to Review

• SKILL.md: Main documentation and workflow overview
• references/messaging-patterns.md: Message templates for common scenarios

FAQ

When should I use team-communication-protocols?

Use this skill when you need to establish or improve communication norms for a new or existing agent team, especially when clarity and coordination are critical for project success.

What platforms does this skill support?

team-communication-protocols is platform-agnostic and can be adapted for use with Slack, Discord, GitHub, or any agent-based collaboration environment.

How do I decide between a direct message and a broadcast?

The skill provides clear guidelines: use message for targeted, actionable communication with a specific teammate, and use broadcast sparingly for information that must reach all team members.

Where can I find message templates?

Ready-to-use templates for common scenarios are available in the references/messaging-patterns.md file within the skill directory.

How do I troubleshoot coordination issues?

Review the anti-patterns and troubleshooting sections in SKILL.md to identify and resolve common communication breakdowns.

For a full list of files and resources, visit the Files tab or browse the repository at GitHub.