Internal Communications Skill
Overview
This skill provides comprehensive guidance for creating professional, effective internal communications across various formats and contexts. It covers everything from weekly status reports to company-wide announcements, with ready-to-use templates and best practices for clear, engaging communication.
Core Communication Principles
1. Know Your Audience
- Identify the primary and secondary audiences
- Understand their information needs and preferences
- Adjust technical depth and formality accordingly
- Consider different communication styles (executives vs. engineers vs. operations)
2. Lead with Impact
- Put the most important information first (inverted pyramid)
- Use clear, concise headlines
- Provide executive summaries for longer communications
- Make action items immediately visible
3. Be Clear and Actionable
- Use specific, concrete language
- Define clear next steps and owners
- Include deadlines and timelines
- Avoid jargon unless audience-appropriate
4. Show Progress with Data
- Use metrics to demonstrate impact
- Provide context for numbers (trends, comparisons)
- Visualize data when possible
- Balance quantitative and qualitative information
5. Balance Transparency with Tact
- Be honest about challenges and setbacks
- Frame problems with potential solutions
- Acknowledge uncertainty when appropriate
- Celebrate wins without exaggeration
6. Make Content Scannable
- Use clear headings and subheadings
- Employ bullet points and numbered lists
- Highlight key information with bold or color
- Keep paragraphs short (3-4 lines max)
Communication Types
Status Reports
Purpose: Provide regular updates on progress, challenges, and priorities.
Standard Structure:
- Executive Summary (1-2 sentences)
- Key Metrics & Progress
- Accomplishments/Wins
- Challenges & Blockers
- Upcoming Priorities
- Help Needed
- Resources & Links
Frequency Options: Daily, weekly, monthly, or quarterly
See examples/status-report-template.md for complete template.
Company Newsletters
Purpose: Build company culture, share news, and recognize achievements.
Standard Sections:
- From Leadership (optional, monthly)
- Company Updates & Milestones
- Team Spotlights & Recognition
- New Hires & Announcements
- Upcoming Events
- Learning & Development
- Fun Section (photos, memes, celebrations)
Best Practices: Keep it visual and engaging, mix serious and fun content, maintain consistent branding.
See examples/newsletter-template.html for complete template.
All-Hands Announcements
Purpose: Communicate important company-wide information requiring immediate attention.
Standard Structure:
- Clear Subject Line (action-oriented)
- TL;DR Summary (2-3 bullet points)
- Context & Background
- The Announcement (what's changing)
- Why This Matters
- What Happens Next (timeline)
- Action Items (if any)
- FAQ Section
- Contact for Questions
See examples/announcement-template.md for complete template.
Team Updates
Purpose: Keep team aligned on progress, learnings, and priorities.
Standard Structure:
- Sprint/Period Summary
- Wins & Accomplishments
- Key Metrics
- Learnings & Retrospective Items
- Upcoming Work
- Team Health & Morale
- Shout-outs & Recognition
See examples/team-update-template.md for complete template.
Policy & Procedural Updates
Purpose: Communicate changes to company policies, processes, or procedures.
Critical Elements:
- What's Changing (clear summary)
- Effective Date
- Why It's Changing (rationale)
- Who It Affects
- What Action Is Required
- Where to Find More Information
- Transition Plan (if applicable)
- FAQ Section
Best Practices: Provide advance notice (2-4 weeks when possible), explain the "why" clearly, offer training or support resources.
See references/templates.md for policy change template.
Change Management Communications
Purpose: Guide organization through significant changes with clear, supportive communication.
Phases:
- Pre-Announcement: Align leadership, identify stakeholders, prepare FAQ
- Initial Announcement: Clear explanation, honest rationale, timeline
- Ongoing Updates: Regular progress reports, address concerns, celebrate milestones
- Post-Implementation: Lessons learned, success metrics, recognition
Communication Frequency During Change: Daily or every 2-3 days for major changes, weekly for medium changes, bi-weekly for minor changes.
Recognition & Celebrations
Purpose: Acknowledge achievements, milestones, and contributions to build culture.
Standard Format:
- Exciting headline
- What happened/was achieved
- Why it matters
- Who was involved (credit everyone)
- Impact or outcomes
- Congratulations and thanks
Best Practices: Be timely, be specific about contributions, include photos or visuals, share widely.
See references/templates.md for recognition template.
Incident Communications
Purpose: Provide clear, timely updates during and after incidents.
During Incident: Update every 30-60 minutes with status, impact, progress, and ETA.
Post-Incident: Conduct blameless post-mortem with timeline, root cause, impact assessment, lessons learned, and action items.
See references/workflows.md for complete incident communication framework.
Tone and Style Guidelines
Professional Yet Approachable
Do: Use conversational but clear language, write like you speak (but edited), show personality within bounds.
Don't: Use corporate jargon or buzzwords, write in overly formal language, sacrifice clarity for cleverness.
Example:
- ❌ "We are pleased to announce that the strategic initiative has reached its preliminary milestone."
- ✅ "Great news! We've hit our first major milestone on the customer portal redesign."
Transparency and Authenticity
Do: Share both good news and challenges, admit when you don't know something, explain the reasoning behind decisions.
Don't: Spin bad news into forced positivity, hide problems until they're critical, exaggerate accomplishments.
Inclusive Language
Do: Use gender-neutral language, avoid idioms that don't translate well, be mindful of cultural differences, consider time zones for global teams.
Don't: Use unnecessarily gendered language, use phrases like "obviously" or "simply", reference culture-specific events only.
Action-Oriented Messaging
Do: Use active voice, start with verbs, make requests specific, set clear deadlines, define ownership.
Don't: Use passive voice excessively, be vague about expectations, leave actions unassigned.
Example:
- ❌ "A decision needs to be made about the framework."
- ✅ "Sarah, please decide which framework we're using by Friday."
Appropriate Formality by Context
Formal (All-hands, policy changes): Complete sentences, professional tone, minimal emoji.
Semi-Formal (Status reports, team updates): Conversational but professional, personality appropriate, occasional emoji.
Informal (Slack, quick updates): Conversational and brief, emoji and GIFs appropriate, fragments acceptable.
Detailed Resources
Complete Workflows
For step-by-step workflows including time estimates and optimization tips, see:
references/workflows.md- Detailed workflows for status reports, newsletters, announcements, team updates, crisis communications, and feedback collection
Best Practices by Medium
For channel-specific guidance, see:
references/best-practices-by-medium.md- Email, Slack/chat, wiki, meetings, and video communications
Templates
For complete templates and examples, see:
examples/status-report-template.md- Weekly engineering status templateexamples/newsletter-template.html- Company newsletter templateexamples/announcement-template.md- All-hands announcement template- `examples/team-upda