Internal Comms

SkillMonitoring & ops

Your AI can write internal company communications, weekly 3P updates (progress, plans, problems), newsletters, FAQ roundups, and incident reports, in your company's format. Once added, it can draft, edit, and format anything meant for an internal audience, from status reports to leadership updates.

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

After adding it, describe the update you need — for example, a weekly 3P report or an incident summary — and your AI will draft it in your company's format.

Then ask your AI: use the Internal Comms skill

What your AI can do with it

  • Draft weekly 3P updates covering progress, plans, and problems
  • Write company-wide newsletters
  • Compile FAQ roundups for internal audiences
  • Turn incident details into clear incident reports
  • Prepare status reports, project updates, and leadership updates
  • Edit and format internal communications in your company's format

What this skill tells your AI

The instructions your AI receives, as published by alirezarezvani/claude-skills in .gemini/skills/team-communications/SKILL.md and read by ahel’s review.

Originally contributed by maximcoding — enhanced and integrated by the claude-skills team.

Write polished internal communications by loading the right reference file, gathering context, and outputting in the company's exact format.

Routing

Identify the communication type from the user's request, then read the matching reference file before writing anything:

TypeTrigger phrasesReference file
3P Update"3P", "progress plans problems", "weekly team update", "what did we ship"references/3p-updates.md
Newsletter"newsletter", "company update", "weekly/monthly roundup", "all-hands summary"references/company-newsletter.md
FAQ"FAQ", "common questions", "what people are asking", "confusion around"references/faq-answers.md
Generalanything internal that doesn't match abovereferences/general-comms.md

If the type is ambiguous, ask one clarifying question — don't guess.

Workflow

  1. Read the reference file for the matched type. Follow its formatting exactly.
  2. Gather inputs. Use available MCP tools (Slack, Gmail, Google Drive, Calendar) to pull real data. If no tools are connected, ask the user to provide bullet points or raw context.
  3. Clarify scope. Confirm: team name (for 3Ps), time period, audience, and any specific items the user wants included or excluded.
  4. Draft. Follow the format, tone, and length constraints from the reference file precisely. Do not invent a new format.
  5. Present the draft and ask if anything needs to be added, removed, or reworded.

Tone & Style (applies to all types)

  • Use "we" — you are part of the company.
  • Active voice, present tense for progress, future tense for plans.
  • Concise. Every sentence should carry information. Cut filler.
  • Include metrics and links wherever possible.
  • Professional but approachable — not corporate-speak.
  • Put the most important information first.

When tools are unavailable

If the user hasn't connected Slack, Gmail, Drive, or Calendar, don't stall. Ask them to paste or describe what they want covered. You're formatting and sharpening — that's still valuable. Mention which tools would improve future drafts so they can connect them later.


Anti-Patterns

Anti-PatternWhy It FailsBetter Approach
Writing updates without reading the reference template firstOutput won't match company format — user has to reformatAlways load the matching reference file before drafting
Inventing metrics or accomplishmentsInternal comms must be factual — fabrication destroys trustOnly include data the user provided or MCP tools retrieved
Using passive voice for accomplishments"The feature was shipped" hides who did the work"Team X shipped the feature" — active voice credits the team
Writing walls of text for status updatesLeadership scans, doesn't read — key info gets buriedLead with the headline, follow with 3-5 bullet points
Sending without confirming audienceA team update reads differently from a company-wide newsletterAlways confirm: who will read this?

Related Skills

SkillRelationship
project-management/senior-pmBroader PM scope — status reports feed into PM reporting
project-management/meeting-analyzerMeeting insights can feed into 3P updates and status reports
project-management/confluence-expertPublish comms as Confluence pages for permanent record
marketing-skill/content-productionExternal comms — use for public-facing content, not internal

Signals

GitHub stars
27k
Forks
4k
Last commit
Aug 2026
Advanced
Item type
skill
Key
team-communications
Source
github.com/alirezarezvani/claude-skills