skills/customer-apology-crafter/SKILL.md
Writes genuine, non-corporate apologies after service failures, outages, missed commitments, or other situations where the customer was let down. Provides multiple framing options calibrated to the severity of the failure and the state of the relationship. Use when asked to write an apology email, draft a service failure response, compose a mea culpa, acknowledge a mistake to a customer, or when any situation requires a formal acknowledgement that something went wrong. Also triggers for questions about customer apologies, service recovery communications, trust repair, or handling a situation where the company made a mistake.
npx skillsauth add stephenrogan/csm-skills customer-apology-crafterInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Writes apologies that are genuine, specific, and accountable. The bar: would you feel respected and heard if you received this? If not, rewrite.
Most corporate apologies fail because they apologise for the inconvenience instead of the failure, hedge accountability with passive voice, or rush to the solution before acknowledging the impact. This skill produces apologies that do none of those things.
Provide:
Every effective apology has five elements, in this order:
State the failure in plain language. Do not soften it, minimise it, or use passive voice.
| Bad | Good | |-----|------| | "We apologise for any inconvenience" | "We missed the deployment deadline by 8 days" | | "There was an issue with the system" | "Our API was down for 4 hours during your peak usage period" | | "The timeline was impacted" | "We committed to delivering the integration by March 1 and did not meet that commitment" |
Describe the effect on the customer's business. Do not talk about how you feel -- the customer does not care that you are "deeply sorry." They care that you understand what this cost them.
| Bad | Good | |-----|------| | "We are deeply sorry for the disruption" | "Your analytics team could not run reports for 4 hours, which I understand delayed your board prep" | | "We regret any negative experience" | "Your team had to build workarounds for the 8 days we missed the deadline" |
If you do not know the full impact, say so: "I want to understand the full impact on your team -- can you help me see what this cost you?"
Share the root cause if you know it. The customer deserves to understand why, but the explanation must not become a deflection.
| Bad | Good | |-----|------| | "Due to unforeseen circumstances..." | "We underestimated the complexity of the database migration" | | "A third-party vendor caused the issue" | "The issue originated in our infrastructure provider, but it is our responsibility to have redundancy in place, and we did not" |
If you do not know the root cause yet: "We are still investigating the root cause and I will share what we find."
Specific actions, not promises. The customer has already heard "we will do better."
| Bad | Good | |-----|------| | "We are taking steps to ensure this does not happen again" | "We are implementing automated failover for the API endpoint (live by March 20) and adding a monitoring alert that triggers at 99.5% uptime deviation" | | "We will improve our processes" | "I am restructuring the deployment timeline to include a 3-day buffer for integration milestones" |
The apology is the start of the recovery, not the end. Offer to talk, listen, and address further.
"I would like to discuss this with you directly. Are you available for a call this week? I want to make sure we have fully addressed the impact and that you are confident in our plan going forward."
| Severity | Tone | Length | Channel | Who Sends | |----------|------|--------|---------|----------| | Minor (small delay, cosmetic issue) | Straightforward, brief | 3-5 sentences | Email | CSM | | Moderate (missed commitment, noticeable disruption) | Serious, accountable | 5-8 sentences | Email, followed by call | CSM | | Major (extended outage, significant business impact) | Grave, executive-level | Full structured apology, potentially from CSM + leadership | Call first, then written follow-up | CSM + CS leadership or executive | | Critical (data loss, security incident, public-facing failure) | Formal incident response | Structured incident report with apology | Call from leadership, followed by formal written communication | Executive level |
| Phrase | Why It Fails | |-------|-------------| | "We apologise for any inconvenience" | "Any" suggests you are not sure there was one. "Inconvenience" minimises the impact. This is the most hollow phrase in corporate apologies | | "Unfortunately..." | Signals that what follows is bad news you wish you did not have to deliver. Just deliver it | | "The issue was caused by..." (passive) | Who caused it? Own it. "We caused the issue by..." | | "We take this very seriously" | Proving you take it seriously through action is more credible than declaring it | | "Please don't hesitate to reach out" | If you want them to call, say so directly: "Call me at [number] if you want to discuss" | | "Going forward, we will..." (without specifics) | Promises without specifics are not commitments. They are hopes |
For each situation, the skill produces:
development
Structures the CSM's week based on their portfolio status, upcoming events, overdue items, and strategic priorities. Produces a time-blocked plan that balances reactive demands with proactive account management. Use when asked to plan a week, structure daily priorities, build a weekly schedule, allocate time across accounts, manage a busy week, or when a CSM feels overwhelmed and needs to determine where to focus. Also triggers for questions about time management, weekly planning, account prioritisation for the week, daily priority setting, or how to balance competing demands across a portfolio.
development
Constructs a compelling value narrative for a customer account by connecting product usage to business outcomes in the customer's language. Produces different versions for different audiences -- the champion, the CFO, the board. Use when asked to build a value story, articulate ROI, create a business case for the customer, prepare value evidence for a renewal or QBR, or when a CSM needs to translate usage metrics into business impact the customer will recognise. Also triggers for questions about value articulation, ROI storytelling, customer business case, value evidence, or how to prove the product is worth the investment.
data-ai
Takes raw usage data -- even a spreadsheet export or pasted metrics -- and identifies patterns, risks, and opportunities. Translates product analytics into account intelligence a CSM can act on. Use when asked to interpret usage data, analyse product metrics, make sense of a usage report, identify trends in customer behaviour, flag usage-based risks, or when a CSM has data but does not know what it means for the account. Also triggers for questions about usage analysis, product analytics interpretation, behavioural pattern detection, usage-based risk identification, or turning raw metrics into actionable insight.
development
Builds a structured 30-60-90 day plan for a CSM taking over a new book of accounts or joining a new team. Prioritises accounts by risk and value, identifies immediate relationship actions, and structures the ramp to full productivity. Use when asked to plan a book transition, create a new CSM onboarding plan, structure a territory takeover, build a 30-60-90 plan for a new role, or when a CSM is inheriting accounts and needs a systematic approach to getting up to speed. Also triggers for questions about account transitions, new book ramp-up, CSM onboarding to a portfolio, territory planning, or how to take over accounts from another CSM.