eol-message skill

EOL Message

Purpose

Craft a clear, empathetic End-of-Life (EOL) message that communicates discontinuation, explains the rationale, addresses customer impact, provides transition support, and positions what comes next. Use this to maintain customer trust during a difficult transition and reduce the churn that comes from customers feeling abandoned.

This is not a generic sunset announcement — it's a customer-centric communication that acknowledges loss while framing the change as progress. And it is sized to the change: a deprecated toggle gets a paragraph, a flagship retirement gets phased communications across months.

Input

Works best with: What's being retired (product, feature, or plan) and roughly when.

Also useful: The rationale, affected customer segments, migration or replacement path, support commitments, and any contract or regulatory language that constrains what you can say.

Anything supplied with the invocation itself — text after the skill name, a pasted context dump, or an appended ARGUMENTS: line — counts as answers already given. Use it and skip whatever it covers; don't re-ask.

Arriving empty-handed? That works too. The skill asks for the what/when/why and the landing place before drafting, then recommends a message size you can override. An EOL message without a stated rationale and a next step reads as abandonment — so those two get asked for either way.

Example invocations:

• Draft an EOL message: retiring our legacy reporting module Dec 31, replaced by the new analytics dashboard; 400 accounts affected.
• We're killing a feature nobody uses. Give me the brief version — no replacement, 3 weeks notice.

Key Concepts

Size the Message to the Change

The most common EOL messaging failure isn't tone — it's proportion. A six-section announcement for a deprecated checkbox trains customers to ignore your notices. A one-line notice for a product carrying real workflows creates a support incident.

Most announcements are Standard. Recommend a size, explain why in one line, and let the user move it. If they choose Brief for something you'd have sized Standard, note the single thing that gets lost — usually the phase table, which is what prevents "wait, when does it stop working?" tickets.

The Three Transition Paths

What you're really telling customers is where they land. There are three answers, and they produce genuinely different messages:

carries forward, what improves. Positioning matters most here.

1. Replacement — another product of yours takes over. The message leans on continuity: what

leans on mechanics: what customers must do, by when, and how much work it is. Be honest about effort; understating it is the fastest route to distrust.

1. Migration — same product family, different tier, configuration, or platform. The message

export, generous notice, and real alternatives including competitors. Naming a competitor costs less than the reputation damage of stranding people.

1. Graceful exit — nothing replaces it. The message leans on dignity: honest reasoning, data

The graceful exit is the one teams write badly, because it's the one they feel worst about. It is also the one customers judge you on hardest.

Lifecycle Gates (shared vocabulary)

EOL is not one date, and collapsing the gates into a single announcement is what generates the "but I thought it still worked" support wave:

• GA (General Availability): Actively sold and fully supported
• NSC (Notice of Status Change): The decision is communicated; planning begins
• EOS (End of Sale): No new customers can purchase
• EOE (End of Expansion): Existing customers cannot add capacity or seats
• EOR (End of Renewal): Existing contracts will not be renewed
• EOM (End of Maintenance): Bug fixes and patches stop
• EOL (End of Life): The product is retired
• EOSRV (End of Service): All support and service obligations end

Brief messages name two or three gates. Full messages name all eight in a table. Whichever gates you use, define them in the customer's terms — "you can keep using it, but we won't ship fixes" beats "EOM: 3/2027."

The EOL Messaging Framework

An effective EOL message balances honesty about the change with empathy for customer impact:

1. Company context: Who you are and your commitment to customers
2. The announcement: What's ending and what's replacing it
3. The rationale: Why this benefits customers (not just the business)
4. Current product context: What the product was and who it served
5. Customer impact: How this affects users (acknowledge the disruption)
6. Transition solution: The landing place and how it compares
7. Support measures: How you'll help them get there
8. Timeline: Key dates and gates
9. Call to action: Next steps and contact info

Why This Works

• Empathy-first: Acknowledges disruption before justifying the decision
• Clarity: No ambiguity about what's changing and when
• Support-focused: Shows you're not abandoning customers mid-transition
• Future-oriented: Frames change as progress, not loss

The Sticky-Note Rule

A customer should be able to write what they must do, and by when, on a sticky note after one read. If they can't, the message is decoration. Test every draft against this before sending.

Anti-Patterns (What This Is NOT)

• Not a terse shutdown notice: "We're discontinuing Product X. Goodbye."
• Not business-centric: Don't lead with "This reduces our costs"
• Not vague: "Soon" is not a timeline
• Not defensive: Don't blame customers ("low usage forced us to shut down")
• Not uniform: The same template at the same length for every sunset is the proportion failure

When to Use This

• Discontinuing a product, feature, or service
• Migrating customers from legacy to new platform
• Sunsetting an acquired product
• Deprecating a technology stack or API

When NOT to Use This

• For minor tweaks that don't change what customers can do (don't over-communicate)
• Before you have a transition plan (communicate after you know how you'll support customers)
• If you're secretly hoping customers won't notice (be transparent)

Application

Use template.md for the full fill-in structure.

Step 1: Establish size and path

Before drafting, settle two things:

Size: Brief, Standard, or Full. Recommend one from the blast radius — customer count, revenue, contracts, whether hardware or partners are involved — then let the user override. Say in one line what a smaller size leaves out.

Path: Replacement, Migration, or Graceful exit. This determines what the message emphasizes and whether the Transition Solution section is a positioning statement or an exit plan.

Step 2: Gather context

• Product being discontinued: What specifically is ending?
• Landing place: What's replacing it, if anything?
• Timeline: Which gates apply, and what date does each land on?
• Customer impact: How many users? What workflows disrupted?
• Support plan: Migration help, training, discounts, data export tools
• Rationale: Why is this happening?
• Constraints: Contract language, regulatory requirements, "lifetime" promises made

If missing context: Don't send until you have a transition plan. Customers will ask "What do I do now?" — you must have an answer. Drafting is fine; sending is not.

Step 3: Draft the transition narrative

Company Context

**We are:** [Company and its relationship to the product being phased out]
- [Commitment to customers]
- [How the product line evolves]
- [Where you're headed]

Example:

**We are:** Fieldlight, a field service management platform serving 4,000 service businesses
- We're committed to getting your technicians to the right job with the right information
- We continuously evolve the platform based on how crews actually work
- We're building toward scheduling that adapts in real time to what happens in the field

The Announcement

**Announcing:**
- [Single sentence stating the EOL clearly and naming the landing place]

Example: "We are retiring Fieldlight Classic Dispatch on December 31, 2026, and moving all accounts to Fieldlight Next Scheduling."

Graceful exit variant: "We are retiring Fieldlight Route Optimizer on June 30, 2027. We do not have a replacement, and we want to be direct about that."

The Rationale (customer-benefit-focused)