Skills

Professional Communication

Guide technical communication for software developers.

Install

npx skills add softaworks/agent-toolkit --skill professional-communication -g -a claude-code -y
Category
Engineering
Updated
8mo ago
License
MIT
Context cost
Mediumabout 2,156 tokens
Runs scripts
No, instructions only

What it does

Guide technical communication for software developers. Covers email structure, team messaging etiquette, meeting agendas, and adapting messages for technical vs non-technical audiences. Use when drafting professional messages, preparing meeting communications, or improving written communication.

Professional Communication

Overview

This skill provides frameworks and guidance for effective professional communication in software development contexts. Whether you're writing an email to stakeholders, crafting a team chat message, or preparing meeting agendas, these principles help you communicate clearly and build professional credibility.

Core principle: Effective communication isn't about proving how much you know - it's about ensuring your message is received and understood.

When to Use This Skill

Use this skill when:

  • Writing emails to teammates, managers, or stakeholders
  • Crafting team chat messages or async communications
  • Preparing meeting agendas or summaries
  • Translating technical concepts for non-technical audiences
  • Structuring status updates or reports
  • Improving clarity of written communication

Keywords: email, chat, teams, slack, discord, message, writing, communication, meeting, agenda, status update, report

Core Frameworks

The What-Why-How Structure

Use this universal framework to organize any professional message:

ComponentPurposeExample
WhatState the topic/request clearly"We need to delay the release by one week"
WhyExplain the reasoning"Critical bug found in payment processing"
HowOutline next steps/action items"QA will retest by Thursday; I'll update stakeholders Friday"

Apply to: Emails, status updates, meeting talking points, technical explanations

Three Golden Rules for Written Communication

  1. Start with a clear subject/purpose - Recipients should immediately grasp what your message is about
  2. Use bullets, headlines, and scannable formatting - Nobody wants a wall of text
  3. Key messages first - Busy people appreciate efficiency; state your main point upfront

Audience Calibration

Before communicating, ask yourself:

Read the whole SKILL.md on GitHub

More in Engineering