nps-theme-analysis

Analyzes NPS and CSAT survey responses from Google Sheets and posts weekly theme summaries to Slack.

20.2k|3.4k|Updated Oct 5, 2024
One-click install
npx skills add https://github.com/kortix-ai/suna --skill nps-theme-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nps-theme-analysis
Source: https://github.com/kortix-ai/suna/tree/main/packages/starter/templates/marketplace/runtime/skills/nps-theme-analysis
Command: npx skills add https://github.com/kortix-ai/suna --skill nps-theme-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Customer-success teams receive raw NPS/CSAT survey exports that are tedious to read and hard to turn into actionable insight. This Skill automates the weekly analysis: it reads the survey sheet, clusters free-text comments into themes, isolates detractor drivers, tracks score movement, and delivers one readable Slack summary.

Core Features & Use Cases

  • Theme Clustering: Groups free-text survey comments into recurring themes by meaning, with representative quotes and score-band attribution.
  • Detractor Driver Analysis: Ranks the themes pulling detractors down this week and flags drivers that are new or growing versus prior periods.
  • Score Trend Tracking: Computes the current NPS/CSAT score from full sheet history and attributes movement to promoters, passives, or detractors.
  • Use Case: A CS team exports Typeform responses into a Google Sheet; every Monday the agent reads the sheet, clusters the week's comments, and posts a digest with top themes, detractor drivers, and score movement to the team's Slack channel.

Quick Start

Ask the agent to analyze this week's NPS survey responses from the configured Google Sheet and post the theme summary to the report channel.

Frequently Asked Questions about nps-theme-analysis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze NPS survey responses automatically?

Point the agent at the Google Sheet containing your survey export. It reads the full response history, bands scores into promoters, passives, and detractors, clusters comments into themes, and posts a weekly summary with quotes to Slack.

How to track NPS trends week over week from Google Sheets?

The agent recomputes the score from the sheet's full history each run using the standard %promoters minus %detractors formula, then compares it to prior periods and attributes the movement to shifts in promoters, passives, or detractors.

Does this work with CSAT surveys as well as NPS?

Yes. For CSAT, the agent maps the top band of whatever scale the sheet uses to promoter-equivalent, the middle to passive, and the bottom to detractor, then applies the same theme clustering and trend analysis.

Can the agent update the survey sheet or contact respondents?

No. The skill is strictly read-only on the Google Sheet and report-only in output. It never edits rows, never contacts respondents, and never opens tickets; the only output is one Slack message per run.

Why does each weekly run recompute themes from scratch?

Each cron run spawns a fresh session with no memory, so themes, bands, and trends are always recomputed from the sheet's own history. This prevents stale state or drift from accumulating between runs.