customer-service-excellence
Use when handling a customer service interaction (especially recovery, escalation, or public complaint), drafting service language (apology, empathy, ownership, escalation, confirmation), measuring service quality, aligning frontline empowerment with escalation paths, or designing a service-failure prevention loop. Encodes the recovery-and-retention loop, difficult-interaction frameworks, and CX-EX alignment rules.
Best use case
customer-service-excellence is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Use when handling a customer service interaction (especially recovery, escalation, or public complaint), drafting service language (apology, empathy, ownership, escalation, confirmation), measuring service quality, aligning frontline empowerment with escalation paths, or designing a service-failure prevention loop. Encodes the recovery-and-retention loop, difficult-interaction frameworks, and CX-EX alignment rules.
Teams using customer-service-excellence should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/customer-service-excellence/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How customer-service-excellence Compares
| Feature / Agent | customer-service-excellence | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Use when handling a customer service interaction (especially recovery, escalation, or public complaint), drafting service language (apology, empathy, ownership, escalation, confirmation), measuring service quality, aligning frontline empowerment with escalation paths, or designing a service-failure prevention loop. Encodes the recovery-and-retention loop, difficult-interaction frameworks, and CX-EX alignment rules.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
SKILL.md Source
# Customer Service Excellence
Acknowledgement: Shared by Peter Bamuhigire, techguypeter.com, +256 784 464178.
<!-- dual-compat-start -->
## Use When
- Handling a live service issue (complaint, error, delay, escalation, public-channel post).
- Drafting service language: apology, empathy, ownership, timeline, confirmation, escalation, refusal.
- Designing or auditing the service recovery and retention loop.
- Measuring service quality across response, resolution, recovery, retention.
- Aligning frontline empowerment with escalation paths and knowledge management (CX-EX alignment).
- Building a prevention loop so the same failure does not recur.
## Do Not Use When
- The work is pre-sale conversation; use `premium-client-sales`.
- The work is product feature evaluation; use `product-discovery`.
- The work is internal team conflict unrelated to a customer; use a coaching framework.
- The work is marketing copy at the top of the funnel; use the marketing/positioning skill.
## Required Inputs
- The customer's words (verbatim where possible) and the channel they used.
- Account context: tenure, value, prior issues, contract terms.
- The actual failure: what happened, what was promised, what gap.
- Authority limits of the agent handling the interaction (refund cap, credit cap, escalation triggers).
## Workflow
1. Run the **recovery-and-retention loop**: listen, acknowledge, diagnose, explain, options, act, confirm, document, prevent, follow up. Do not skip steps; the order matters.
2. Match the interaction type to a **difficult-interaction framework** (angry, anxious, technical-novice, executive, public-channel) and adapt language accordingly.
3. Use **service language patterns** for apology, empathy, ownership, timeline, confirmation, escalation. Each pattern has a structure and a prohibited phrase list.
4. Honour the **frontline empowerment ceiling**: if the resolution exceeds the agent's authority, escalate immediately rather than negotiating beyond authority.
5. Close with **explicit confirmation**: name what was done, what comes next, and the date the customer can hold you to.
6. Document the interaction with structured tags so it feeds the **service quality measurement** dashboard and the **prevention loop**.
7. Run a follow-up after resolution. Without follow-up, recovery is half-done.
## Quality Standards
- The customer's words are mirrored before any explanation begins.
- Apology is specific and ownership-bearing, not "we apologize for any inconvenience".
- Every commitment has a date, an owner, and a confirmation channel.
- Escalation is a service tool, not a defeat. Escalate before negotiating beyond authority.
- Public-channel responses move to private channel for resolution but acknowledge publicly first.
- Every documented failure produces either a knowledge-base entry, a process change, or a known-acceptable-loss decision.
## Anti-Patterns
- Apologising in passive voice ("mistakes were made"). Specific ownership outperforms generic regret.
- Explaining policy before acknowledging impact.
- Promising a callback "soon" instead of a specific time window.
- Treating the angry customer's tone as the issue. The tone is data; the issue is the failure.
- Closing the ticket because the customer went silent. Silence is not resolution.
- Making the customer repeat the story to a second agent. Hand-off discipline is part of service.
- Using empathy phrases as filler. Empathy without diagnosis is theatre.
## Outputs
- A resolved or escalated case with named owner and date.
- A written confirmation to the customer (channel of their choice).
- A structured tag set for measurement (response time, resolution path, recovery used, retention outcome).
- A prevention entry: knowledge-base update, process change, or accepted-loss note.
- A follow-up scheduled at an explicit date.
## Evidence Produced
| Category | Artifact | Format | Example |
|----------|----------|--------|---------|
| Operability | Service recovery plan | Markdown with acknowledgement, owner, update cadence, escalation, and closure condition | `docs/service/recovery-plan.md` |
| Release evidence | Support language script set | Markdown library for acknowledgement, referral, escalation, follow-up, and recovery | `docs/service/support-scripts.md` |
| UX quality | Service quality dashboard definition | Markdown or CSV with response, resolution, recurrence, and satisfaction metrics | `docs/service/service-quality-dashboard.md` |
## References
- `references/recovery-and-retention-loop.md` for the ten-step loop and exit criteria per step.
- `references/service-language-patterns.md` for apology, empathy, ownership, timeline, confirmation, escalation, refusal patterns with prohibited phrases.
- `references/difficult-interaction-frameworks.md` for angry, anxious, technical-novice, executive, public-channel handling.
- `references/service-quality-measurement.md` for the four-metric dashboard (response, resolution, recovery success, retention impact).
- `references/cx-ex-alignment.md` for frontline empowerment, escalation paths, and knowledge management.
- Use `continuous-improvement-system` to feed prevention entries into operating cadence reviews.
- Use `premium-client-sales` for the inverse direction (pre-sale conversations).
<!-- dual-compat-end -->
## Recovery and Retention Loop (the order, every time)
Listen -> Acknowledge -> Diagnose -> Explain -> Options -> Act -> Confirm -> Document -> Prevent -> Follow up.
Skipping listen produces explanation theatre. Skipping diagnose produces apology theatre. Skipping prevent produces the same failure next month. Skipping follow up produces silent churn.
## Authority Ceiling Rule
Frontline agents must have a published refund cap, credit cap, and escalation trigger. Negotiating beyond authority destroys two relationships at once: the customer's trust (they sense the discomfort) and the agent's relationship with their manager (escalating after a promise burns capital both ways).
## The Public-Channel Move
Public complaint -> public acknowledgement (under one hour, no defence, no detail) -> private channel handover -> resolution in private -> public closing note (only if the customer agrees). Resolving in public is theatre and invites pile-on.
## Service Failure Prevention Loop
Every documented failure produces one of three outcomes:
- A knowledge-base entry (the agent could have answered with the right information).
- A process change (the system allowed the failure; fix it or it recurs).
- An accepted-loss note (the failure cost is below the prevention cost; document and move on).
Without the third option, prevention loops accumulate well-meaning policy that no one follows.Related Skills
microservices-architecture
Use when designing, reviewing, or refactoring microservice boundaries, communication, service ownership, deployment independence, resilience, and distributed data flows. Load absorbed microservices fundamentals, models, communication, and resilience references as needed.
ai-agent-sla-and-customer-commitments
Use when defining agent SLAs, customer commitments, SLA dashboards, credits, support promises, and service evidence for agentic AI products.
web-app-security-audit
Use when auditing a PHP/JavaScript/HTML web application for security vulnerabilities. Covers configuration, authentication, authorization, input validation, XSS, API security, HTTP headers, and dependency scanning. Produces a severity-rated audit...
vibe-security-skill
Use when designing or reviewing security for a web application, API, or multi-tenant SaaS — produces threat model, abuse case list, auth/authz matrix, and secret handling plan; covers OWASP Top 10 2025 and the AI-code-generation blind spots. Neighbours — api-design-first owns auth model fields, deployment-release-engineering owns secret rotation choreography, ai-security and llm-security own model-specific threats.
network-security
Use when designing, hardening, or auditing network-layer security for self-managed Debian/Ubuntu SaaS infrastructure — firewalls (nftables/UFW), WAF (ModSecurity + OWASP CRS), VPN (WireGuard, OpenVPN, IPsec), TLS/PKI ops, IDS/IPS (Suricata, Fail2ban), zero-trust, SSH hardening, DDoS mitigation, DNS security. Complements web-app-security-audit (app layer) and cicd-devsecops (secrets/CI).
linux-security-hardening
Use when hardening a Debian/Ubuntu server — user/group/sudo hardening, file permission audits, PAM password policy + MFA, AppArmor mandatory access control, auditd system call logging, kernel sysctl hardening, file integrity monitoring (AIDE), rootkit detection (rkhunter/chkrootkit), unattended security patching, GRUB + UEFI + LUKS boot security, and CIS benchmark compliance.
dpia-generator
Generate a Data Protection Impact Assessment (DPIA), Uganda DPPA 2019-compliant. Use when producing or reviewing a data protection impact assessment, a privacy impact assessment, when uganda-dppa-compliance flags [DPIA-REQUIRED], or when processing large-scale or sensitive personal data for a new feature.
code-safety-scanner
Scan any codebase for 14 critical safety issues across security vulnerabilities, server stability (500 errors), and payment misconfigurations. Use when auditing code before deployment, reviewing AI-generated code for production readiness, or...
world-class-engineering
Use when designing, building, reviewing, or upgrading production software systems that must be secure, performant, maintainable, scalable, and user-centered. Apply before writing specs, code, architecture, APIs, databases, mobile apps, SaaS platforms, or ERP systems.
update-Codex-documentation
Update project documentation files (README.md, PROJECT_BRIEF.md, TECH_STACK.md, ARCHITECTURE.md, docs/API.md, docs/DATABASE.md, AGENTS.md, docs/plans/NEXT_FEATURES.md) when significant changes occur. MANDATORY at end of each work session to...
skill-writing
Use when creating or upgrading skills in this repository. Covers repository-specific frontmatter rules, progressive disclosure, reference-file strategy, validation, and the quality bar required for production-grade engineering skills.
skill-safety-audit
Scan new or updated skills for unsafe or malicious instructions (unknown tools, external installers, credential harvesting) before accepting them into the repository.