CtrlK
BlogDocsLog inGet started
Tessl Logo

ux-research

Plan and execute user research including research planning, recruiting, interview design, qualitative synthesis, and translating findings into product decisions. Use this skill whenever the user wants to plan user research, design interviews, recruit participants, conduct discovery, run formative research, or synthesize qualitative findings. Triggers on user research, UX research, user interviews, discovery research, generative research, formative research, qualitative research, user insights, research synthesis, recruitment, interview guide, jobs to be done. Also triggers when product decisions are being made without user input and the user wants to fix that.

63

Quality

75%

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 ./skills/ux-research/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

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 strong skill description that clearly articulates specific capabilities, provides comprehensive trigger terms covering multiple synonyms and variations, and explicitly states both what the skill does and when to use it. The description is well-structured with a clear 'Use this skill whenever...' clause and an enumerated list of trigger terms, making it highly effective for skill selection among many options.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: research planning, recruiting, interview design, qualitative synthesis, and translating findings into product decisions. These are distinct, actionable capabilities.

3 / 3

Completeness

Clearly answers both 'what' (plan and execute user research including planning, recruiting, interview design, synthesis, translating findings) and 'when' (explicit 'Use this skill whenever...' clause plus a detailed triggers list). The situational trigger about product decisions without user input adds further completeness.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'user research', 'UX research', 'user interviews', 'discovery research', 'generative research', 'formative research', 'qualitative research', 'interview guide', 'jobs to be done', 'recruitment', 'research synthesis'. These are terms practitioners and non-practitioners alike would naturally use.

3 / 3

Distinctiveness Conflict Risk

The description carves out a clear niche around user/UX research with highly specific domain terminology (formative research, generative research, jobs to be done, interview guide) that is unlikely to conflict with other skills like general product management or data analysis skills.

3 / 3

Total

12

/

12

Passed

Implementation

50%

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

This is a comprehensive UX research skill that covers the full research lifecycle with good structure and practical guidance. Its main weaknesses are verbosity (explaining concepts a capable AI already knows), lack of truly executable templates inline, and missing validation checkpoints in the workflow. The referenced interview guide template is absent from the bundle, undermining progressive disclosure.

Suggestions

Trim explanatory content Claude already knows (e.g., what diary studies are, basic interviewing etiquette) and focus on decision-relevant heuristics and non-obvious guidance.

Include the interview guide template inline or as an actual bundle file rather than referencing a file that doesn't exist.

Add explicit validation gates to the workflow (e.g., 'Before recruiting: confirm research question passes the decision-relevance test with stakeholders' or 'After 3 sessions: check if guide needs revision based on emerging themes').

Provide a complete, copy-paste-ready research plan template alongside the findings document template to increase actionability.

DimensionReasoningScore

Conciseness

The skill is well-structured but includes some content Claude already knows (e.g., explaining what diary studies are, basic interviewing anti-patterns like 'don't interrupt'). Several sections could be tightened—the 'When to use' and 'When NOT to use' lists overlap with the description, and some guidance is general UX knowledge rather than novel instruction.

2 / 3

Actionability

The skill provides concrete frameworks, tables, and a findings document template, which are useful. However, it lacks executable artifacts—the interview guide template is referenced but not included in the bundle, and the guidance is largely descriptive rather than providing copy-paste-ready templates or specific commands. The research plan and interview guide outputs are named but not fully templated inline.

2 / 3

Workflow Clarity

The 9-step workflow is clearly sequenced and includes a pilot step (validation checkpoint). However, there are no explicit validation gates or feedback loops between steps—e.g., no criteria for when framing is 'good enough' to proceed, no checkpoint after recruiting to verify sample quality, and no explicit 'if synthesis reveals gaps, go back and conduct more sessions' loop. For a multi-step process with significant risk of wasted effort, this is a gap.

2 / 3

Progressive Disclosure

The skill references an external interview guide template and cross-references other skills (usability-testing, journey-mapping, analytics-strategy), which is good structure. However, the bundle has no files, so the referenced template doesn't exist. The main file is also quite long (~300 lines) with content that could be split into separate reference files (e.g., synthesis methods, recruiting playbook, communication formats).

2 / 3

Total

8

/

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
rampstackco/claude-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.