customer-support

Guidelines for handling customer support interactions. Use when responding to user inquiries, troubleshooting issues, or escalating problems.

22,487 stars

Best use case

customer-support is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Guidelines for handling customer support interactions. Use when responding to user inquiries, troubleshooting issues, or escalating problems.

Teams using customer-support 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

$curl -o ~/.claude/skills/customer-support/SKILL.md --create-dirs "https://raw.githubusercontent.com/mastra-ai/mastra/main/examples/unified-workspace/skills/customer-support/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/customer-support/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How customer-support Compares

Feature / Agentcustomer-supportStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Guidelines for handling customer support interactions. Use when responding to user inquiries, troubleshooting issues, or escalating problems.

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 Support Guidelines

## Overview

This skill provides guidelines for professional customer support interactions. Apply these patterns when responding to user inquiries, troubleshooting issues, or handling escalations.

**Keywords**: customer support, help desk, troubleshooting, user inquiry, ticket handling, escalation

## Response Framework

### HEAR Method

1. **H**ear - Acknowledge the customer's issue
2. **E**mpathize - Show understanding
3. **A**ssess - Gather information
4. **R**esolve - Provide solution or next steps

### Response Template

```
Hi [Name],

Thank you for reaching out about [brief issue summary].

[Empathy statement if appropriate]

[Solution or information]

[Clear next steps]

Best regards,
[Agent name]
```

## Tone Guidelines

### Do

- Use clear, simple language
- Be professional but friendly
- Acknowledge frustration when appropriate
- Provide specific, actionable information
- Set realistic expectations

### Don't

- Use jargon or technical terms without explanation
- Be defensive or dismissive
- Make promises you can't keep
- Blame the customer or other teams
- Use ALL CAPS or excessive punctuation

## Common Scenarios

### Password Reset

```
Hi [Name],

I can help you reset your password. Here's how:

1. Go to [login page URL]
2. Click "Forgot Password"
3. Enter your email address
4. Check your inbox for the reset link (also check spam)
5. The link expires in 24 hours

If you don't receive the email within 5 minutes, let me know and I'll investigate further.
```

### Billing Question

```
Hi [Name],

I've looked into your billing question.

[Specific answer with amounts/dates]

For reference:
- Your billing cycle: [date]
- Current plan: [plan name]
- Next charge: [amount] on [date]

If you'd like to make changes to your subscription, I can help with that too.
```

### Technical Issue

```
Hi [Name],

I understand you're experiencing [issue]. Let me help troubleshoot.

First, can you confirm:
1. [Specific question 1]
2. [Specific question 2]
3. Any error messages you're seeing?

In the meantime, you can try:
- [Quick fix option 1]
- [Quick fix option 2]

This will help me identify the root cause faster.
```

## Escalation Criteria

### Escalate Immediately

- Security concerns (account compromise, data breach)
- Legal or compliance issues
- Threats or harassment
- Executive escalation requests
- System-wide outages

### Escalate After First Attempt

- Issue persists after standard troubleshooting
- Customer requests supervisor
- Refund/credit requests above threshold
- Complex billing disputes
- Technical issues requiring engineering

### Document Before Escalating

1. Customer information
2. Issue summary
3. Steps already taken
4. Customer's desired outcome
5. Urgency level

## Response Time SLA

| Channel | First Response | Resolution Target |
| ------- | -------------- | ----------------- |
| Chat    | 2 minutes      | 15 minutes        |
| Email   | 4 hours        | 24 hours          |
| Phone   | Immediate      | 10 minutes        |
| Social  | 1 hour         | 4 hours           |

## Closing Interactions

### Resolved

```
I'm glad I could help! Is there anything else I can assist you with today?

[If no] Have a great day!
```

### Pending Resolution

```
I've [action taken]. You should see [expected outcome] within [timeframe].

I'll follow up with you [when] to make sure everything is working.
```

### Escalated

```
I've escalated this to our [team name] team. They'll reach out within [timeframe].

Your reference number is [ticket ID]. You can reply to this thread for updates.
```

Related Skills

security-review

22487
from mastra-ai/mastra

Security-focused code review checklist for identifying vulnerabilities

performance-review

22487
from mastra-ai/mastra

Performance-focused code review for identifying bottlenecks and optimization opportunities

code-standards

22487
from mastra-ai/mastra

Code quality standards and style guide for reviewing pull requests

code-review

22487
from mastra-ai/mastra

Provides structured code review guidelines for TypeScript projects. Use when reviewing pull requests, analyzing code quality, or suggesting improvements.

api-design

22487
from mastra-ai/mastra

Guidelines for designing RESTful APIs and TypeScript interfaces. Use when designing new endpoints, reviewing API contracts, or structuring data models.

brand-guidelines

22487
from mastra-ai/mastra

Applies Mastra's brand colors, typography, and writing style to documentation, code examples, or artifacts. Use when brand colors, style guidelines, visual formatting, or company design standards apply.

tailwind-best-practices

22487
from mastra-ai/mastra

Tailwind CSS styling guidelines for Mastra Playground UI. This skill should be used when writing, reviewing, or refactoring styling code in packages/playground-ui and packages/playground to ensure design system consistency. Triggers on tasks involving Tailwind classes, component styling, or design tokens.

smoke-test

22487
from mastra-ai/mastra

Create a Mastra project using create-mastra and smoke test the studio in Chrome

react-best-practices

22487
from mastra-ai/mastra

React performance optimization guidelines from Mastra Engineering. This skill should be used when writing, reviewing, or refactoring React code to ensure optimal performance patterns. Triggers on tasks involving React components, data fetching, bundle optimization, or performance improvements.

ralph-plan

22487
from mastra-ai/mastra

Interactive planning assistant that helps create focused, well-structured ralph-loop commands through collaborative conversation

mastra-docs

22487
from mastra-ai/mastra

Documentation guidelines for Mastra. This skill should be used when writing or editing documentation for Mastra. Triggers on tasks involving documentation creation or updates.

e2e-tests-studio

22487
from mastra-ai/mastra

REQUIRED when modifying any file in packages/playground-ui or packages/playground. Triggers on: React component creation/modification/refactoring, UI changes, new playground features, bug fixes affecting studio UI. Generates Playwright E2E tests that validate PRODUCT BEHAVIOR, not just UI states.