internal-comms

The internal-comms skill streamlines the generation of structured documentation within an organization. It manages the drafting of routine updates, such as project status reports, Progress-Plans-Problems (3P) summaries, and company-wide newsletters. By enforcing standardized templates housed in the repository, the skill ensures that internal messaging remains consistent in tone and formatting across different departments. It effectively translates raw data or fragmented updates into professional, readable formats that align with established company practices. Users select from defined guideline files to handle specific communication needs, reducing the manual effort required to format reports or FAQs. This tool minimizes the time spent on administrative writing tasks, allowing teams to focus on core operations while maintaining transparency and clarity in their internal discourse.

When to Use This Skill

• •Drafting a weekly 3P update for a direct manager
• •Distributing an incident post-mortem to the engineering team
• •Writing a company newsletter to share recent milestones
• •Constructing an FAQ entry based on common Slack support questions

How to Invoke This Skill

Example prompts that trigger this skill in Claude Code, Cursor, or Antigravity:

• “Help me draft a 3P update for this week
• “Write a company newsletter based on these notes
• “Format this incident data for an internal update
• “Create an FAQ answer for our internal team site
• “Help me write a status report for the project

Pro Tips

• 💡Always specify the exact type of internal communication needed (e.g., 'incident report' vs. 'general update') to ensure the correct template is applied.
• 💡Provide key facts, dates, and relevant stakeholders upfront to ensure the output is highly relevant and accurate.
• 💡Review the generated draft and refine it for specific company voice or sensitive details before final distribution.

What this skill does

• •Generates structured 3P progress reports based on project data
• •Formats technical incidents into clear internal summaries
• •Compiles weekly company newsletters from team inputs
• •Provides standardized answers to recurring internal FAQs
• •Applies organizational tone and formatting guidelines automatically

When not to use it

• ✕Writing public-facing marketing copy or press releases
• ✕Conducting sensitive one-on-one performance reviews
• ✕Drafting legal or highly confidential HR policy documents

Example workflow

1. Provide the raw data or update points to the agent
2. Specify the type of communication required
3. Agent selects the corresponding guideline from the examples directory
4. Agent drafts the message following the template rules
5. Review the output for accuracy and finalize the content

Prerequisites

• –Access to the internal communication guideline files
• –Raw project data or incident details to be summarized

Pitfalls & limitations

• !Failing to provide enough context for non-standard communication types
• !Overlooking specific company tone nuances if guidelines are outdated
• !Assuming the agent knows project status without raw input

FAQ

How it compares

Unlike generic drafting prompts that may hallucinate structure, this skill uses mandatory template files to ensure compliance with organization-specific communication standards.

Source & trust

Recommended Rules

Recommended Workflows

Recommended MCP Servers