research-synthesis

Synthesize user research into themes, insights, and recommendations. Use when you have interview transcripts, survey results, usability test notes, support tickets, or NPS responses that need to be distilled into patterns, user segments, and prioritized next steps.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./design/skills/research-synthesis/SKILL.md

Quality

Content

68%Weight 40%Scale 1-5

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

A clean, well-structured synthesis skill that gives a concrete output template and input expectations. Its main gap is the absence of an explicitly sequenced process with validation checkpoints.

Suggestions

Add a short numbered process (e.g., 1. ingest and normalize inputs, 2. code themes with prevalence counts, 3. cross-reference connector data, 4. validate insights against evidence) to lift workflow clarity.

Include one brief worked example of a filled-in theme block so the output template is unambiguous in practice.

Trim or tighten the Tips section so every line earns its place, pushing conciseness toward the 5 anchor.

Dimension	Reasoning	Score
Conciseness	The body is lean — a structured input list, output template, and tips with no padding about what research synthesis is; minor trimming possible in the Tips section, fitting the 4 anchor rather than the perfectly lean 5.	4 / 5
Actionability	A concrete copy-paste output template with placeholders plus a defined input list gives mostly executable guidance, but no worked filled-in example is provided, so it stops at the 4 anchor.	4 / 5
Workflow Clarity	The body presents an output format and inputs rather than an explicitly sequenced process with checkpoints; steps are implied but not enumerated, matching the 3 anchor.	3 / 5
Progressive Disclosure	Well-organized into clear sections with one-level-deep references (CONNECTORS.md, the user-research skill) and no nested references; minor organization gaps keep it at the 4 anchor.	4 / 5
	Total	15 / 20 Passed

Description

88%Weight 40%Scale 1-5

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

A strong, third-person description that clearly answers both what and when with concrete trigger terms. Minor room to broaden trigger-term synonyms and sharpen distinctiveness from the related user-research skill.

Dimension	Reasoning	Score
Specificity	"Synthesize user research into themes, insights, and recommendations" and "distilled into patterns, user segments, and prioritized next steps" name multiple concrete outputs with comprehensive coverage, matching the 5 anchor.	5 / 5
Completeness	It explicitly states what ("Synthesize user research into themes, insights, and recommendations") and when ("Use when you have interview transcripts..."), with concrete trigger phrases matching the 5 anchor.	5 / 5
Trigger Term Quality	"interview transcripts, survey results, usability test notes, support tickets, or NPS responses" gives good natural-term coverage, but a few common variants (e.g., "user research", "customer feedback") are absent, fitting the 4 anchor rather than 5.	4 / 5
Distinctiveness Conflict Risk	The user-research-synthesis niche is clear with distinct triggers, but the body's reference to a related "user-research" skill signals minor overlap risk, fitting the 4 anchor.	4 / 5
	Total	18 / 20 Passed

Validation

87%

Warnings & errors only

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

Validation — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning
relative_links	Relative link issues: 1 suspicious	Warning

	Total	14 / 16 Passed

Repository: anthropics/knowledge-work-plugins
Path: design/skills/research-synthesis/SKILL.md
Commit: 6d223a7

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.