CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cs-ux-researcher

UX research agent for research planning, persona generation, journey mapping, and usability test analysis. Use when product decisions need user evidence — e.g., planning interview scripts and recruiting criteria for a discovery study, or synthesizing usability-test sessions into prioritized findings and updated personas.

61

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.gemini/skills/cs-ux-researcher/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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.

The body is well-structured and highly actionable — every workflow has concrete executable commands, expected outputs, and time estimates — but it suffers from significant verbosity and redundancy: the purpose is stated three times, reference listings are duplicated across sections, and low-value bash examples pad the workflows. Consolidating repeated content and moving KPIs/examples to referenced files would materially improve it.

Suggestions

Collapse the Purpose section to 2-3 sentences and delete the redundant restatements of the agent's positioning.

List each referenced file exactly once — merge the Knowledge Bases tables, inline `cat` examples, and final References section into a single reference inventory with paths and use cases.

Move the Success Metrics KPIs and the three Integration Example scripts into a referenced file (e.g., an assets/success-metrics.md), keeping only a pointer and one representative example in SKILL.md.

Document `rice_prioritizer.py` (path, usage, features) alongside the other Python tools, since Workflow 3 depends on it.

DimensionReasoningScore

Conciseness

The ~520-line body is noticeably verbose with padded, redundant sections: the Purpose section repeats the same positioning three times ("focused on research planning, persona creation, journey mapping, and usability test analysis", "ensures that user needs drive product development", "bridges the gap between raw user data and design decisions"), and workflow bash examples add little beyond echoing headers and `cat`-ing files (e.g., `echo "Journey Mapping - Onboarding Flow"`). It is above a 1 because the content is domain knowledge Claude doesn't inherently have (tool paths, workflow specifics) rather than explanations of basic concepts, but the padding and repetition are pervasive.

2 / 5

Actionability

Concrete, executable commands dominate: `python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py interview-001.txt > insights-001.json`, copy-paste loops (`for f in interviews/*.txt; do ... done`), and template copies (`cp .../research_plan_template.md onboarding-research-plan.md`). Minor gaps keep it below 5: `rice_prioritizer.py` is invoked in Workflow 3 without any usage documentation or feature list like the other tools get, and example filenames (research-data.json, journey-opportunities.csv) appear without a note on how they are produced.

4 / 5

Workflow Clarity

All four workflows (research planning, persona generation, journey mapping, usability test analysis) have clearly numbered steps with expected outputs and time estimates, and persona work includes a validation checkpoint ("Validate Personas - Ensure accuracy: Cross-reference with quantitative data... Review with customer-facing teams"). It falls short of 5 because validation checkpoints are advisory review steps rather than explicit validate-and-fix loops — e.g., Workflow 4's 'Analyze Results' has no instruction for what to do when metrics contradict or sessions fail, and there is no re-test confirmation step beyond 'Plan re-test for critical issues after fixes'.

4 / 5

Progressive Disclosure

References are present and one level deep with explicit paths (e.g., `../../product-team/skills/ux-researcher-designer/references/persona-methodology.md`), but the same reference inventory is repeated three times (Knowledge Bases tables, per-step `cat` examples, and the final References section), and substantial content that belongs in separate files is inlined — the Success Metrics section (~25 lines of KPIs) and three full Integration Example scripts add bulk without navigation value. This matches 'some structure but could be better organized; content that should be separate is inline' rather than the 'minor organization gaps' of a 4.

3 / 5

Total

13

/

20

Passed

Description

92%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 description: concrete capability list, explicit 'Use when...' trigger guidance with two concrete example scenarios, and a distinct UX-research niche. The only meaningful gap is some missing natural synonym variations (e.g., 'user interviews', 'user research') in the trigger phrasing.

Suggestions

Add common user-voiced synonyms such as 'user interviews', 'user research', or 'usability testing' to the trigger clause to broaden natural keyword coverage.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — "research planning, persona generation, journey mapping, and usability test analysis" — which comprehensively cover the agent's stated scope, matching the anchor for multiple specific concrete actions with comprehensive coverage. It is not the level below (4) because coverage of the domain's core activities is complete rather than having minor gaps.

5 / 5

Completeness

It explicitly answers both questions: what it does ("research planning, persona generation, journey mapping, and usability test analysis") and when to use it ("Use when product decisions need user evidence — e.g., planning interview scripts and recruiting criteria for a discovery study, or synthesizing usability-test sessions into prioritized findings and updated personas"). This matches the anchor with a clear 'what' plus a concrete 'Use when...' clause with example trigger scenarios; a 4 would require the 'when' to be less explicit or specific.

5 / 5

Trigger Term Quality

Natural trigger terms like "UX research", "persona", "journey mapping", "usability test", "interview scripts", "recruiting criteria", and "user evidence" give good keyword coverage. It falls short of 5 because common synonyms and variations users might say — e.g. "user interviews", "user research", "customer research", "usability testing sessions" — are only partially covered by the exact phrasing present.

4 / 5

Distinctiveness Conflict Risk

The UX-research niche is clear and the triggers (persona generation, journey mapping, usability test analysis, user evidence) are distinct from adjacent product-management territory, giving minimal conflict risk. It is not a 4 because the description does not merely have 'minor overlap risk' — the research-specific trigger phrases would rarely cause a wrong skill to fire.

5 / 5

Total

19

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (532 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 3 missing, 8 suspicious

Warning

Total

13

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/cs-ux-researcher/SKILL.md

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.