CtrlK
BlogDocsLog inGet started
Tessl Logo

user-research

Plan, conduct, and synthesize user research. Trigger with "user research plan", "interview guide", "usability test", "survey design", "research questions", or when the user needs help with any aspect of understanding their users through research.

52

Quality

56%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./design/skills/user-research/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

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

This is a solid skill description with excellent trigger terms and completeness. Its main weakness is that the 'what' portion is somewhat high-level—'plan, conduct, and synthesize' could be more specific about concrete deliverables (e.g., interview scripts, affinity diagrams, research reports). Overall it would perform well in a multi-skill selection scenario.

Suggestions

Expand the capability list with more specific concrete actions/outputs, e.g., 'create interview scripts, design survey questionnaires, build discussion guides, synthesize findings into research reports or personas.'

DimensionReasoningScore

Specificity

The description names the domain (user research) and lists some actions ('plan, conduct, and synthesize'), but these are fairly high-level. It doesn't list specific concrete outputs or actions like 'create interview scripts, design survey questionnaires, analyze research findings, build persona documents.'

2 / 3

Completeness

Clearly answers both 'what' (plan, conduct, and synthesize user research) and 'when' (explicit trigger terms listed plus a broader 'when the user needs help with any aspect of understanding their users through research'). The 'Trigger with' clause serves as an explicit 'Use when' equivalent.

3 / 3

Trigger Term Quality

Includes strong natural trigger terms that users would actually say: 'user research plan', 'interview guide', 'usability test', 'survey design', 'research questions'. These cover multiple common variations of how users would phrase requests in this domain.

3 / 3

Distinctiveness Conflict Risk

The description carves out a clear niche around user research specifically, with distinct trigger terms like 'interview guide', 'usability test', and 'survey design' that are unlikely to conflict with other skills such as general data analysis or UX design skills.

3 / 3

Total

11

/

12

Passed

Implementation

22%

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

This skill reads more like a reference card or cheat sheet than actionable guidance for Claude. It lists research concepts and frameworks that Claude likely already knows without providing the concrete templates, example outputs, or step-by-step workflows that would make it genuinely useful. The skill needs to shift from describing what user research is to instructing Claude on how to produce specific research artifacts.

Suggestions

Add concrete, copy-paste-ready templates for key deliverables (e.g., a research plan template with filled-in example, a sample interview guide with actual questions and probes).

Define a clear end-to-end workflow: e.g., 1) Clarify research objectives → 2) Select method → 3) Draft research plan → 4) Create interview/test guide → 5) Define analysis approach → 6) Produce synthesis report, with validation checkpoints at each stage.

Remove or drastically reduce the methods table and analysis framework list—Claude already knows these concepts. Instead, focus on decision criteria (when to recommend one method over another based on user's constraints) and specific output formats.

Add at least one complete example showing input (user request) → output (e.g., a full interview guide or research plan) so Claude knows the expected quality and format.

DimensionReasoningScore

Conciseness

The content is reasonably efficient with good use of tables and lists, but includes some information that Claude already knows (e.g., what affinity mapping is, what A/B testing is, general research method descriptions). The table format is efficient, but the analysis framework section is essentially listing well-known UX concepts without adding novel guidance.

2 / 3

Actionability

The skill is almost entirely descriptive rather than instructive. It lists methods, frameworks, and deliverables but provides no concrete templates, example outputs, specific question formulations, or executable guidance. There's no example of what a research plan document should look like, no sample interview questions, and no template for a synthesis report.

1 / 3

Workflow Clarity

There is no clear workflow for conducting research end-to-end. The interview guide structure provides a rough sequence for one method, but there's no overall process for planning, executing, and synthesizing research. No validation checkpoints exist (e.g., how to verify research questions are well-formed, how to check for bias in interview guides, when to pivot methods).

1 / 3

Progressive Disclosure

The content is organized into logical sections with clear headers, which is good. However, for a skill covering this many methods and deliverables, the content is either too shallow (needing deeper references) or too broad without any referenced files for detailed templates, examples, or method-specific guides.

2 / 3

Total

6

/

12

Passed

Validation

100%

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

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
anthropics/knowledge-work-plugins
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.