internal-comms

Overview

Provides a structured approach to writing internal communications in company-preferred formats. It guides you to identify the communication type, select the right guideline, and craft messages that follow the required tone and structure.

How This Skill Works

Identify the communication type from the request. Load the matching guideline from the examples directory (3P updates, company newsletters, FAQs, or general comms) and follow its formatting, tone, and content rules. If the type doesn’t match any guideline, ask for clarification.

When to Use It

• 3P updates (Progress, Plans, Problems) for team leadership and stakeholders
• Company newsletters that share quarterly or monthly messages
• FAQ responses addressing common questions
• Status reports on ongoing initiatives or projects
• Incident reports documenting outages, incidents, and resolutions

Quick Start

1. Step 1: Identify the communication type from the request.
2. Step 2: Load the matching guideline from the examples directory (3p-updates.md, company-newsletter.md, faq-answers.md, or general-comms.md).
3. Step 3: Draft the message following the guideline’s formatting, tone, and content gathering instructions.

Best Practices

• Identify the communication type from the request
• Load the appropriate guideline file from examples/ directory
• Follow the specific instructions in that file for formatting, tone, and content gathering
• Use the company's preferred sections, terminology, and style
• If the type doesn't match any guideline, ask for clarification or more context

Example Use Cases

• Draft a 3P update to leadership highlighting progress, upcoming plans, and any problems.
• Compose a company newsletter announcing Q2 milestones and organizational updates.
• Prepare an FAQ response answering a commonly asked question about a new policy.
• Create a status report summarizing a project’s current state for sponsors.
• Generate an incident report documenting a system outage and the steps taken to restore service.

Frequently Asked Questions