eol-communication

Imported from borghei/claude-skills (project-management/execution/eol-communication/SKILL.md). Install upstream with npx skills add borghei/claude-skills --skill eol-communication. Copyright stays with the author (MIT + Commons Clause).

EOL Communication Expert

Overview

Create clear, empathetic End-of-Life (EOL) communications that preserve customer trust and facilitate smooth transitions. Sunsetting a product is a high-stakes communication challenge -- done poorly, it damages brand trust and accelerates churn across your entire portfolio. Done well, it strengthens customer relationships and drives migration to replacement solutions.

The work runs in four phases: (1) Pre-announcement planning (what, why, who, when, what support, what risks), (2) Craft the message (transition narrative, customer impact, transition solution, timeline, one CTA), (3) Segment and distribute (different message and channel per segment), (4) Support and monitor (support FAQ, migration tracking, churn watch). See the playbook reference for the full framework, templates, and timeline guidance.

Clarify First

Before crafting the EOL communication, settle the inputs below. When one is missing or vague and would change the result, ask about it; when it wouldn't, use a sensible default and say which one you used.

• What is being sunset and why: drives the transition narrative and Phase 1 planning; a vague "why" reads as abandonment.
• Replacement / migration path: drives the transition solution and the single CTA; if it is broken or absent, do not announce yet.
• Timeline and key dates: drives the timeline section and varies sharply by product type (API vs paid product vs free feature).
• Customer segments affected: drives the Phase 3 segment/channel matrix; high-value accounts need different message and outreach than self-serve.

Ask about the two or three inputs that matter most for this request, not the whole list. If the user wants a result straight away, produce it and state your assumptions at the top.

When to Use

• Product sunset -- Discontinuing an entire product or product line.
• Feature deprecation -- Removing a significant feature from an existing product.
• Service migration -- Moving customers from one platform or infrastructure to another.
• API retirement -- Deprecating API versions or endpoints.
• Pricing model change -- Major pricing restructure that effectively ends old tiers.

When NOT to Use

• Minor feature changes that don't require customer notification.
• Internal tooling changes with no customer impact.
• Bug fixes or patches (use release notes instead).

Anti-Patterns

Announcing before the migration path works

Mistake: The EOL email goes out while the migration tool is still "coming soon". Customers try it at launch, it breaks, and the support queue floods. Why it happens: The shutdown date is set and the announcement feels urgent, so the tooling is assumed to catch up. Instead: Treat a working migration path as a gate. Announce only after at least 10 real customers have migrated in production on the path you are about to recommend.

Vague timeline

Mistake: The message says "in the coming months" or "later this year" with no dates. Why it happens: Some dates are not locked yet, and soft wording feels safer than committing. Instead: Search the draft for "coming", "later", "in due course" and "soon", and replace each with a date. Give every milestone a date: announcement, new signups closed, feature freeze, data export deadline, shutdown.

Customer-facing staff learn from customers

Mistake: Internal Slack hears about the EOL a minute after the public post, and a sales rep first hears of it from a customer on a call. Why it happens: Internal comms feel like a formality next to the external message. Instead: Brief sales, CS and support 7-10 business days before the external announcement, with the internal FAQ in hand. Before T-0, ask 3 customer-facing employees what the EOL message is. If they hesitate, hold the announcement.

Nine more, each with a bad and a good example: references/red-flags.md.

References

• references/playbook.md — read this when crafting a sunset announcement: the 4-phase EOL framework, the messaging template and writing rules, the segment/channel matrix, the internal support FAQ, the monitoring checklist, timeline best practices by product type, troubleshooting, and success criteria.
• references/red-flags.md — read this before sending the message to Legal and Support for review: common ways an EOL message, timeline, or migration plan goes wrong with bad/good examples anchored to the 4-phase framework.

Scope & Limitations

In Scope: EOL message creation, timeline planning, segment-specific messaging, internal FAQ preparation, migration monitoring framework, customer objection handling, support team preparation.

Out of Scope: Replacement product development, data migration tooling implementation, legal contract review, refund processing, technical infrastructure decommissioning.

Important Caveats: EOL communication is only as good as the transition path behind it. If the replacement product isn't ready or the migration path is broken, the best-written message won't prevent customer frustration. Ensure migration tooling is tested before announcing.

Integration Points