Agent skill

Feedback Synthesis

by shawnpang in shawnpang/startup-founder-skills

When the user needs to analyze, categorize, or extract actionable insights from customer feedback across multiple sources, especially feature requests.

MITAuto-check passedSales & Support

Install Feedback Synthesis

skills CLI
$ npx skills add shawnpang/startup-founder-skills --skill feedback-synthesis -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install shawnpang/startup-founder-skills feedback-synthesis --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/shawnpang/startup-founder-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/feedback-synthesis .claude/skills/feedback-synthesis && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
feedback-synthesis
GitHub stars
343
Token cost
~2.2k tokens
SKILL.md length
1,022 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
MIT

At a glance

When the user needs to analyze, categorize, or extract actionable insights from customer feedback across multiple sources, especially feature requests.

  • Works in 8 steps: Understand the goal -- Confirm the… → Collect and normalize -- Gather feedback… → Categorize into themes -- Group related… → …
  • Needs to analyze
  • SKILL.md covers When to Use, Context Required, Workflow and Output Format, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Feedback Synthesis is an agent skill from shawnpang/startup-founder-skills. When the user needs to analyze, categorize, or extract actionable insights from customer feedback across multiple sources, especially feature requests.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Sales & Support, covering Customer feedback analysis. The repository describes itself as: AI agent skills for tech startup founders — fundraising, sales, product, recruiting, engineering, legal, ops, and growth. Works with Claude Code, Cursor, Codex, and any Agent… The licence is MIT.

When your agent uses it

  • Needs to analyze
  • Extract actionable insights from customer feedback across multiple sources
  • Especially feature requests

Example prompts

  • “/feedback-synthesis”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Understand the goal -- Confirm the product objective and desired outcomes that will guide prioritization. Feedback analysis without a…
  2. Collect and normalize -- Gather feedback from all sources. If data is in structured formats (CSV, spreadsheet), create summary tables…
  3. Categorize into themes -- Group related requests and feedback together. Name each theme. Focus on identifying the underlying opportunity…
  4. Assess strategic alignment -- For each theme, evaluate how well it aligns with the stated product goals and company strategy.
  5. Score with Opportunity Score -- Use the Opportunity Score framework (Dan Olsen): Opportunity Score = Importance x (1 - Satisfaction)…
  6. Prioritize top opportunities -- Select the top 3 themes based on impact (customer value and breadth of users affected), effort…
  7. Deep-dive top items -- For each top opportunity, document: rationale, alternative solutions worth considering, high-risk assumptions, and…
  8. Present findings -- Deliver a structured synthesis with executive summary first, supporting data second, and recommended actions third.

What it can do on your machine

Read from SKILL.md and the folder at commit 4ad31b4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Feedback Synthesis loads about 2.2k tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 1,022 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from shawnpang/startup-founder-skills at commit 4ad31b4, republished under its MIT licence (© shawnpang). 1,022 words, ~2,248 tokens.

Download SKILL.mdSave it as .claude/skills/feedback-synthesis/SKILL.md (or your agent's skills folder).
name
feedback-synthesis
description
When the user needs to analyze, categorize, or extract actionable insights from customer feedback across multiple sources, especially feature requests.
related
user-research-synthesis, churn-analysis, prd-writing
reads
startup-context

Feedback Synthesis

When to Use

Activate when a founder or product lead needs to make sense of customer feedback from multiple sources -- support tickets, NPS surveys, user interviews, app store reviews, social media, sales call notes, feature request logs, spreadsheets, or CSVs. This includes prompts like "analyze our customer feedback," "what are users asking for most," "prioritize feature requests," "triage this backlog," or "what themes are showing up in our support tickets."

Context Required

  • From startup-context: product type, customer segments, current product roadmap priorities, company stage, strategic goals, and product objectives.
  • From the user: the raw feedback data (or access to it), the sources being analyzed, the time period, the product goal or desired outcomes guiding prioritization, and the decision this analysis will inform.

Workflow

  1. Understand the goal -- Confirm the product objective and desired outcomes that will guide prioritization. Feedback analysis without a strategic lens produces noise, not signal.
  2. Collect and normalize -- Gather feedback from all sources. If data is in structured formats (CSV, spreadsheet), create summary tables. Each piece of feedback becomes a row with source, date, customer segment, verbatim quote, and sentiment.
  3. Categorize into themes -- Group related requests and feedback together. Name each theme. Focus on identifying the underlying opportunity (problem) rather than the surface-level feature request.
  4. Assess strategic alignment -- For each theme, evaluate how well it aligns with the stated product goals and company strategy.
  5. Score with Opportunity Score -- Use the Opportunity Score framework (Dan Olsen): Opportunity Score = Importance x (1 - Satisfaction), normalized to 0-1. This prioritizes problems that matter most and are least well-served today.
  6. Prioritize top opportunities -- Select the top 3 themes based on impact (customer value and breadth of users affected), effort (development and design resources required), risk (technical and market uncertainty), and strategic alignment (fit with product vision).
  7. Deep-dive top items -- For each top opportunity, document: rationale, alternative solutions worth considering, high-risk assumptions, and how to test those assumptions with minimal effort.
  8. Present findings -- Deliver a structured synthesis with executive summary first, supporting data second, and recommended actions third.

Output Format

Synthesis Report Template
# Customer Feedback Synthesis -- [Period]

## Executive Summary
3-5 key findings. Lead with the most surprising or actionable insight.

## Product Goal Alignment
The stated product objective and how feedback themes map to it.

## Theme Map
| Theme | Frequency | Segments Affected | Opportunity Score | Strategic Alignment | Priority |
|-------|-----------|-------------------|-------------------|---------------------|----------|
| [Theme] | [Count] | [Segments] | [Score] | [High/Med/Low] | [H/M/L] |

## Top 3 Opportunities (Deep Dives)
### Opportunity 1: [Theme Name]
- **Rationale:** Customer needs and strategic alignment
- **Representative quotes:** Direct user language
- **Alternative solutions:** Other ways to address this need
- **High-risk assumptions:** What must be true
- **Cheapest test:** How to validate with minimal effort

## Quick Wins
Actions that address frequent feedback with low implementation effort.

## Not Prioritized (and Why)
Themes explicitly deprioritized with reasoning.

## Appendix: Raw Data Summary
Breakdown by source, segment, and time period.

Frameworks & Best Practices

Opportunities Over Features

Never let customers design solutions. Prioritize opportunities (problems), not features. When a user says "I want a Gantt chart," the underlying opportunity might be "I need to visualize project timelines and communicate status to stakeholders." Always dig for the job-to-be-done behind the request.

Opportunity Score (Dan Olsen)

Score each theme: Opportunity Score = Importance x (1 - Satisfaction), normalized to 0-1. This surfaces problems that are both important and underserved. A high-importance, high-satisfaction area is already well-served and should not be prioritized over a high-importance, low-satisfaction gap.

Signal vs. Noise Rules
  • One customer saying it is not a pattern. Require 3+ independent mentions of a theme before treating it as a signal. Exception: if the one customer is a whale account citing it as a churn risk.
  • Recency bias check. A flood of recent feedback about one issue can overshadow a persistent problem. Always compare against the prior period.
  • Loudest does not equal most important. Power users and vocal customers generate disproportionate feedback. Weight by segment size and revenue contribution, not volume alone.
  • Praise is data too. Track what users love. Knowing your strengths prevents you from accidentally breaking them during a redesign.
Assumption Testing

For each top-priority opportunity, identify the highest-risk assumption and design the cheapest possible test. Do not build the full solution to validate an assumption that could be tested with a prototype, survey, or Wizard of Oz experiment.

Show full SKILL.md (437 more words)Show less
Source-Specific Guidance
SourceStrengthsWatch Out For
Support ticketsHigh signal, specific problemsSkews toward bugs, misses satisfied users
NPS/surveysBroad coverage, quantifiableLow response rates can bias results
Feature request boardsOrganized, vote counts availablePower users dominate voting
Sales call notesRevenue-adjacent, prospect perspectiveProspects request features they may never use
App store reviewsPublic, includes competitor comparisonsSkews negative, vague complaints
Social mediaUnfiltered, real-timeNoisy, hard to segment
Avoiding Common Mistakes
  • Cherry-picking quotes that support a pre-existing hypothesis. Present the full distribution, including contradictory feedback.
  • Conflating frequency with importance. A low-frequency issue that causes churn matters more than a high-frequency annoyance users tolerate.
  • Delivering data without recommendations. A theme map without action items is a report, not a synthesis. Always end with what to do next.
  • Ignoring the silent majority. Users who never complain may be happy or disengaged. Segment analysis helps distinguish the two.
  • user-research-synthesis -- Chain when feedback analysis reveals gaps that need dedicated user research (interviews, usability tests).
  • churn-analysis -- Chain when feedback themes correlate with churn patterns and need deeper retention analysis.
  • prd-writing -- Chain when a clear opportunity emerges from the synthesis and needs to be specced into a PRD.

Examples

Example 1: Feature request prioritization

User: "Our feature request board has 150 items. Help me figure out what to build next quarter."

Good output excerpt:

Executive Summary: 150 requests cluster into 9 themes. The top opportunity is not the most-requested feature (SSO, 34 votes) but the most underserved need: "real-time collaboration on shared documents" (Opportunity Score: 0.82). SSO scores lower (0.45) because existing workarounds satisfy most users adequately.

Opportunity 1: Real-time collaboration

  • Rationale: 22 requests across 4 segments. Cited as expansion blocker in 3 enterprise deals worth $85K ARR. Current satisfaction: 2/10.
  • Alternative solutions: (a) Full real-time editing, (b) Lightweight commenting and presence indicators, (c) Async review workflow with notifications
  • High-risk assumption: Users want simultaneous editing, not just awareness of others' changes
  • Cheapest test: Add presence indicators only (show who is viewing a document) and measure whether collaboration-related tickets decrease
Example 2: Multi-source synthesis

User: "We have 200 support tickets, 50 NPS responses, and notes from 10 customer interviews from last month. What are customers telling us?"

Good output excerpt:

Theme 1: CSV export broken for large datasets (Opportunity Score: 0.91)

  • 47 support tickets, 8 NPS detractors, 3 interviews. Users hitting the 10K row limit work around it by splitting exports manually.
  • Strategic alignment: High -- data export is core to our "open platform" positioning.
  • Cheapest test: Not needed; this is a clear bug/limitation. Fix directly.
  • Quick win: Increase CSV export limit to 100K rows (engineering estimate: 2 days).

© shawnpang, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/feedback-synthesis of shawnpang/startup-founder-skills.

Open the folder on GitHubat commit 4ad31b4

Compare with similar skills

Feedback Synthesis next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Feedback Synthesis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Feedback Synthesis this skillshawnpang/startup-founder-skills343—~2.2kAutomated safety check: PassMIT
Review Analysisliangdabiao/amazon-sorftime-research-MCP-skill9591 repos~2.5kAutomated safety check: PassNone
Bggg Data Amazonbinggandata/bggg-skills605—~1.4kAutomated safety check: PassMIT
Zsxqunnoo/zsxq-skill304—~3.8kAutomated safety check: PassMIT
Roadtrip NavigatorWaybox-AI/roadtrip-skill126—~3.4kAutomated safety check: PassMIT
Always Compareai-analyst-lab/ai-analyst304—~1.4kAutomated safety check: PassMIT

Similar skills

  • Review Analysis

    liangdabiao/amazon-sorftime-research-MCP-skill

    对亚马逊商品评论进行深度分析,自动识别产品痛点、分析退货原因,生成改进建议和客服回复模板。Invoke when user uses /review-analysis command with a product ASIN.

    959 GitHub starsUsed in 1 repo~2.5k tokens
    Sales & SupportAuto-check passed
  • Bggg Data Amazon

    binggandata/bggg-skills

    Collect Amazon.com written product reviews at scale through Woot's public review AJAX route, retain every attempt and error log, reconcile partial runs, and normalize exact review text into…

    605 GitHub stars~1.4k tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed
  • Zsxq

    unnoo/zsxq-skill

    知识星球 CLI(zsxq-cli)与底层接口完整操作指南,涵盖星球和内容管理、Skill Pay 微信支付场景。当用户提到知识星球、zsxq、小密圈、星球、登录/认证、发帖、评论、回答、编辑、删除主题、定时发布/定时任务/定时回答、投票、问答主题、markdown 正文、AI…

    304 GitHub stars~3.8k tokensUpdated 19 days ago
    Sales & SupportAuto-check passed
  • Roadtrip Navigator

    Waybox-AI/roadtrip-skill

    Generate North American road-trip itineraries as a map-first, offline-friendly single-file HTML page.

    126 GitHub stars~3.4k tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed
  • Always Compare

    ai-analyst-lab/ai-analyst

    Never present a metric or number in isolation; anchor every number to a comparison (prior period, benchmark, or another segment) or state that none is available.

    304 GitHub stars~1.4k tokensUpdated 9 days ago
    Sales & SupportAuto-check passed
  • Account Deletion

    gustavscirulis/snapgrid

    Generates an Apple-compliant account deletion flow with multi-step confirmation UI, optional data export, configurable grace period, Keychain cleanup, and server-side deletion request.

    116 GitHub starsUsed in 1 repo~2.5k tokens
    Sales & SupportAuto-check: notes

More from shawnpang/startup-founder-skills

All 50 skills in this repo
  • Accelerator Application

    shawnpang/startup-founder-skills

    When the user wants to apply to startup accelerators, incubators, or fellowship programs.

    343 GitHub stars~2.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Architecture Design

    shawnpang/startup-founder-skills

    When the user needs to design or evaluate system architecture — service boundaries, data models, API contracts, infrastructure topology, database selection, or dependency analysis.

    343 GitHub stars~2.1k tokensUpdated 6 mo ago
    Auto-check passed
  • Board Update

    shawnpang/startup-founder-skills

    When the user needs to write a monthly or quarterly investor update, prepare a board deck, or communicate company progress to stakeholders.

    343 GitHub stars~2.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Churn Analysis

    shawnpang/startup-founder-skills

    When the user needs to identify at-risk accounts, understand why customers are leaving, reduce churn rate, build health scores, design save plays, or create win-back campaigns.

    343 GitHub stars~2.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Cicd Setup

    shawnpang/startup-founder-skills

    When the user needs to set up or improve CI/CD pipelines — GitHub Actions, GitLab CI, deployment automation, or says "set up CI", "automate deployment", "add tests to pipeline", "fix my build".

    343 GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Code Review

    shawnpang/startup-founder-skills

    When the user asks for a code review, shares code for feedback, or says "review this", "check my code", "what's wrong with this".

    343 GitHub stars~1.9k tokensUpdated 6 mo ago
    Auto-check passed

Categories

Questions about Feedback Synthesis

What does Feedback Synthesis do?

When the user needs to analyze, categorize, or extract actionable insights from customer feedback across multiple sources, especially feature requests. Feedback Synthesis is an agent skill from shawnpang/startup-founder-skills. When the user needs to analyze, categorize, or extract actionable insights from customer feedback across multiple sources, especially feature requests.

When should I use Feedback Synthesis?

Feedback Synthesis fits situations like: needs to analyze; extract actionable insights from customer feedback across multiple sources; especially feature requests.

How do I install Feedback Synthesis in Claude Code?

Run `npx skills add shawnpang/startup-founder-skills --skill feedback-synthesis -a claude-code`. Or copy the skill folder (skills/feedback-synthesis in shawnpang/startup-founder-skills) into .claude/skills/feedback-synthesis in your project. Claude Code loads it when a task matches its description.

How do I install Feedback Synthesis in Codex?

Run `npx skills add shawnpang/startup-founder-skills --skill feedback-synthesis -a codex`. Or copy the skill folder (skills/feedback-synthesis in shawnpang/startup-founder-skills) into .agents/skills/feedback-synthesis in your project. Codex loads it when a task matches its description.

Can I use Feedback Synthesis in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add shawnpang/startup-founder-skills --skill feedback-synthesis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/feedback-synthesis, .gemini/skills/feedback-synthesis, .github/skills/feedback-synthesis and .opencode/skills/feedback-synthesis in your project.

What does Feedback Synthesis need to run?

SKILL.md names no scripts, command-line tools or credentials: Feedback Synthesis is instructions for the agent only.

Does Feedback Synthesis access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Feedback Synthesis safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Feedback Synthesis use?

Feedback Synthesis is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Feedback Synthesis use?

About 2.2k tokens (SKILL.md is roughly 9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Feedback Synthesis?

Skills that share tags, products or a category with Feedback Synthesis: Review Analysis (liangdabiao/amazon-sorftime-research-MCP-skill, 959 stars), Bggg Data Amazon (binggandata/bggg-skills, 605 stars), Zsxq (unnoo/zsxq-skill, 304 stars) and Roadtrip Navigator (Waybox-AI/roadtrip-skill, 126 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Feedback Synthesis?

shawnpang (a GitHub user) maintains it in shawnpang/startup-founder-skills, which has 343 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on March 16, 2026.

Source: shawnpang/startup-founder-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.