CtrlK
BlogDocsLog inGet started
Tessl Logo

feedback-synthesis

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

77

Quality

72%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/feedback-synthesis/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

67%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description adequately communicates when to use the skill with an explicit trigger clause and identifies the domain of customer feedback analysis. However, it could be more specific about the concrete actions performed and include more natural trigger terms that users would actually say. The actions listed (analyze, categorize, extract insights) are somewhat generic and could benefit from more concrete examples of outputs or capabilities.

Suggestions

Add more specific concrete actions such as 'rank feature requests by frequency, identify sentiment trends, tag feedback by theme, generate prioritized feature request reports'.

Expand trigger terms to include common variations like 'user feedback', 'product feedback', 'survey responses', 'support tickets', 'reviews', 'NPS scores', 'voice of customer'.

DimensionReasoningScore

Specificity

The description names the domain (customer feedback) and some actions (analyze, categorize, extract actionable insights), but these are somewhat generic and don't list truly concrete, specific actions like 'rank feature requests by frequency' or 'generate summary reports'.

2 / 3

Completeness

The description answers both 'what' (analyze, categorize, extract actionable insights from customer feedback) and 'when' (when the user needs to work with customer feedback across multiple sources, especially feature requests) with an explicit trigger clause starting with 'When the user needs to'.

3 / 3

Trigger Term Quality

Includes some natural keywords like 'customer feedback', 'feature requests', and 'actionable insights', but misses common variations users might say such as 'user feedback', 'product requests', 'NPS', 'survey responses', 'reviews', or 'support tickets'.

2 / 3

Distinctiveness Conflict Risk

The focus on customer feedback and feature requests provides some distinctiveness, but 'analyze' and 'extract actionable insights' are broad enough that this could overlap with general data analysis or text analysis skills. The 'multiple sources' qualifier helps but isn't strongly distinctive.

2 / 3

Total

9

/

12

Passed

Implementation

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a strong, highly actionable skill that provides concrete frameworks, scoring formulas, and detailed examples with realistic data. Its main weakness is length—at this size, some content (frameworks, source guidance tables, examples) could be split into referenced files for better progressive disclosure. The workflow is well-structured with implicit validation checkpoints, and the examples effectively demonstrate what good output looks like.

Suggestions

Split the Frameworks & Best Practices section and Examples into separate referenced files (e.g., FRAMEWORKS.md, EXAMPLES.md) to reduce the main skill's token footprint and improve progressive disclosure.

Remove the duplicate explanation of the Opportunity Score formula—it appears in both the Workflow step 5 and the Frameworks section.

DimensionReasoningScore

Conciseness

The skill is fairly comprehensive but includes some unnecessary elaboration. The 'When to Use' section is somewhat verbose listing every possible trigger phrase. The frameworks section, while valuable, could be tightened—e.g., the Opportunity Score formula is repeated twice. However, most content earns its place and provides genuinely useful guidance Claude wouldn't inherently know (like the source-specific guidance table and signal vs. noise rules).

2 / 3

Actionability

The skill provides highly concrete, actionable guidance: a specific scoring formula (Opportunity Score = Importance × (1 - Satisfaction)), a complete output template with exact table structures, detailed examples showing what good output looks like with specific numbers and reasoning, and clear criteria for each workflow step. The examples are particularly strong with concrete ARR figures, vote counts, and specific recommended actions.

3 / 3

Workflow Clarity

The 8-step workflow is clearly sequenced with logical progression from goal understanding through data collection, categorization, scoring, prioritization, deep-dives, and presentation. Validation is embedded throughout: step 1 confirms the goal before analysis, step 4 checks strategic alignment before scoring, and the 'Signal vs. Noise Rules' serve as validation checkpoints against common analytical errors. The framework includes explicit feedback loops like recency bias checks and the requirement for 3+ independent mentions.

3 / 3

Progressive Disclosure

The skill references related skills at the end (user-research-synthesis, churn-analysis, prd-writing) which is good navigation. However, the content is quite long and monolithic—the frameworks section, source-specific guidance, common mistakes, and examples could potentially be split into referenced files. The output template alone is substantial. For a skill of this length (~150+ lines), more content splitting would improve discoverability.

2 / 3

Total

10

/

12

Passed

Validation

90%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
shawnpang/startup-founder-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.