charlieviettq/awesome-agent-skill / .claude/skills/cs-analytics
"cs-analytics"
Verified"Measure and optimize customer service performance using CSAT, NPS, CES, First Contact Resolution, and text mining on support tickets. Use this skill when the user needs to evaluate CS team performance, identify top complaint drivers, optimize staffing, or build CS dashboards — even if they say 'is our CS team doing well', 'what are customers complaining about', 'how many agents do we need', or 'build a CS dashboard'.".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.3 KB |
| examples/sample_scenario.md | markdown | 5.9 KB |
| references/nps-methodology.md | markdown | 9.2 KB |
| references/ticket-text-mining.md | markdown | 12.8 KB |
examples/sample_scenario.md
View on GitHub# Example: SoftDev SaaS 客服團隊 Q1 健康檢查
## Scenario
**公司**: Flowbit(台灣 B2B SaaS,提供工作流程自動化工具,客戶以中小企業為主)
**提問者**: CS 主管 Mandy
**問題**: 「Q1 結束了,我有一份原始票單資料(3,200 張工單),但不知道我們表現好不好、哪裡有問題、以及下季要多少人力。幫我分析一下。」
**可用資料**:
- 2026 Q1 工單匯出(含建立時間、關閉時間、分類標籤、指派客服、CSAT 評分、是否重開)
- NPS 季度調查結果
- 每月頭號投訴紀錄(Mandy 手工整理)
---
## Analysis
### Step 1: 建立 Summary Dashboard
從原始資料計算核心指標,與 Q4 2025 對比:
| Metric | Q1 2026 | Q4 2025 | Target | Status |
|--------|---------|---------|--------|--------|
| CSAT | 3.7/5 | 4.1/5 | >4.0 | 🔴 |
| NPS | 22 | 35 | >30 | 🔴 |
| FCR | 61% | 68% | >70% | 🔴 |
| Avg First Response | 6.2 hrs | 3.8 hrs | <4 hrs | 🔴 |
| AHT | 9.1 min | 7.8 min | 5-8 min | 🟡 |
| Escalation Rate | 28% | 19% | <20% | 🔴 |
| Reopen Rate | 4.2% | 3.1% | <5% | 🟢 |
| Ticket Volume | 3,200 | 2,650 | — | ↑ 20.8% |
**第一眼診斷**: 五項指標全部惡化,且票量大幅上升 20.8%。這不是單一問題,而是整體承壓訊號。
---
### Step 2: IRON LAW 檢查 — 滿意度 vs. 效率是否同步惡化?
- CSAT 從 4.1 → 3.7(滿意度下滑)
- FCR 從 68% → 61%(解決品質下滑)
- AHT 從 7.8 → 9.1 min(處理時間上升,未因品質拉長而換來更高 CSAT)
**結論**: 兩個維度同時惡化,且方向一致 — 不是「犧牲效率換品質」或「犧牲品質求速度」,而是容量不足導致整體潰堤。根本原因指向 **人力不足 + 新品功能上線帶來的知識缺口**。
---
### Step 3: Top Contact Reason 分析(Pareto)
從工單分類標籤統計:
| # | 原因 | 工單數 | % | 累積 % | 自助化可能? |
|---|------|--------|---|--------|-----------|
| 1 | API 串接錯誤 / 401 認證失敗 | 768 | 24.0% | 24.0% | ✅ 加 FAQ + Debug Wizard |
| 2 | 帳單 / 方案升降級問題 | 512 | 16.0% | 40.0% | ✅ 後台自助升降級 |
| 3 | Workflow 觸發條件設定不生效 | 448 | 14.0% | 54.0% | 🟡 需影片教學 |
| 4 | 資料匯入失敗(CSV 格式問題) | 320 | 10.0% | 64.0% | ✅ 格式驗證器 |
| 5 | 新功能「條件分支 v2」操作疑問 | 288 | 9.0% | 73.0% | 🟡 待 Help Doc 補足 |
| 其他 | 23 種零散原因 | 864 | 27.0% | 100% | — |
**Pareto 結論**: 前 5 大原因佔 73% 的票量。其中 #1、#2、#4 完全可以透過自助工具消化 — 若成功,可減少約 1,600 張/季(50%)的進線。
---
### Step 4: 新興議題偵測(文字探勘)
對 Q1 工單描述做 TF-IDF 關鍵詞分析,與 Q4 2025 比較新增頻率 > 3× 的詞組:
| 新興詞組 | 出現次數 | 首次大量出現 | 推測原因 |
|---------|---------|------------|---------|
| `條件分支 v2` / `branch logic` | 288 | 2026-01-15 | 新功能 1/12 上線,Help Doc 不足 |
| `webhook timeout` | 156 | 2026-02-01 | 疑似後端效能回退(需工程確認) |
| `無法登入 / SSO` | 94 | 2026-03-10 | 3/8 SSO 更新後出現,需緊急追蹤 |
**行動項**: `webhook timeout` 與 `SSO 登入` 是工程問題,非客服問題,應立即開 P1 ticket 給工程團隊。
---
### Step 5: 人力需求計算
**峰值時段**: 工作日 10:00–12:00,平均 28 張工單/小時
```
Required Agents = 峰值量 × AHT / (60 × 利用率目標)
= 28 tickets/hr × 9.1 min / (60 × 0.75)
= 254.8 / 45
= 5.66 → 6 名客服(峰值)
加計 18% 緩衝(休息 + 會議 + 教育訓練):
6 × 1.18 = 7.1 → 需 7 名客服
```
**現況**: Mandy 目前班表峰值只排 5 名,缺口 2 名。這直接解釋了 Response Time 從 3.8 hrs 拉長到 6.2 hrs。
---
### Step 6: Agent 個人績效比對
| 客服 | CSAT | FCR | AHT | 工單數 | 診斷 |
|------|------|-----|-----|--------|------|
| 小明 | 4.3 | 72% | 7.2 min | 620 | 🌟 標竿,可 shadow |
| 小雯 | 4.1 | 68% | 8.0 min | 580 | 正常 |
| 阿強 | 3.2 | 48% | 11.4 min | 490 | ⚠️ FCR 低 + AHT 高,需 coaching |
| 佳佳 | 3.9 | 65% | 9.5 min | 510 | 輕微低於均值,知識庫補充 |
| Joy | 4.0 | 70% | 8.3 min | 400 | 正常(Q1 中途入職) |
**注意**: NPS 是品牌層級指標,不用於評估個別客服(SKILL.md Gotcha 第 2 條)。
---
## Result
```markdown
# CS Analytics Report: Flowbit Q1 2026
## Summary Dashboard
| Metric | Q1 2026 | Q4 2025 | Target | Status |
|--------|---------|---------|--------|--------|
| CSAT | 3.7/5 | 4.1/5 | >4.0 | 🔴 |
| NPS | 22 | 35 | >30 | 🔴 |
| FCR | 61% | 68% | >70% | 🔴 |
| Avg Response Time | 6.2 hrs | 3.8 hrs | <4 hrs | 🔴 |
| Ticket Volume | 3,200 | 2,650 | — | ↑ 21% |
## Top Contact Reasons (Pareto)
| # | 原因 | 工單數 | % | 自助化可能 |
|---|------|--------|---|----------|
| 1 | API 401 認證失敗 | 768 | 24% | ✅ |
| 2 | 帳單升降級 | 512 | 16% | ✅ |
| 3 | Workflow 觸發設定 | 448 | 14% | 🟡 |
| 4 | CSV 匯入格式 | 320 | 10% | ✅ |
| 5 | 條件分支 v2 操作 | 288 | 9% | 🟡 |
## Emerging Issues
- `webhook timeout` (156 件,2/1 起激增) → 工程 P1
- `SSO 登入失敗` (94 件,3/10 起激增) → 工程緊急追蹤
## Staffing
- 峰值需求: 7 名客服
- 現有排班峰值: 5 名
- 缺口: 短少 2 名(直接原因導致 Response Time 超標)
## Recommendations
1. **立即**: 開工程 ticket 處理 webhook timeout + SSO 問題(可快速消除 250 張/季進線)
2. **本月**: 補招 2 名客服或調整排班,優先覆蓋 10:00–12:00 峰值時段
3. **本季**: 建立 API Debug Wizard + 帳單自助升降級入口(潛在節省 ~1,280 張/季)
4. **Coaching**: 阿強的 FCR (48%) 與 AHT (11.4 min) 同時偏差,安排與小明 shadow 1 週
5. **知識庫**: 補充「條件分支 v2」Help Doc,目標在 4/30 前上線
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |