CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ux-research

Skill de UX Research / Discovery qualitativo — entrevista com usuário, criação de persona baseada em pesquisa, mapa de jornada (journey map), teste de usabilidade qualitativo, arquitetura de informação, card sorting e validação de problema antes de especificar. Antecede o PO (01) e o UI/UX (02): entende PARA QUEM e POR QUE antes de definir O QUÊ e COMO. Base no livro de Fabricio Teixeira (Casa do Código). Trigger em: "pesquisa com usuário", "user research", "UX research", "discovery", "entrevista com usuário", "entrevista em profundidade", "persona", "criar persona", "mapa de jornada", "journey map", "mapa de empatia", "teste de usabilidade", "usability testing", "validar problema", "arquitetura de informação", "card sorting", "taxonomia", "proposição de valor", "produto que ninguém usa", "começar pelo usuário", "focus group".

73

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 well-built skill body: an actionable 6-step protocol with validation checkpoints and redo loops, concrete numbers and templates, and proper one-level-deep reference files that exist and deliver what is promised. The two weaknesses are trimmable anecdote/repetition overhead and references to bundle-external files (GLOBAL.md, policies/*) that do not resolve within this skill's directory.

Suggestions

Trim the illustrative anecdotes (lanterna/QR Code) and consolidate the repeated 'antecede o PO (01) / UI/UX (02)' positioning, which appears in the intro, Posicao no Pipeline, Handoff and Integracao sections, into a single place.

Resolve the dangling references: either bundle minimal copies of GLOBAL.md and the five policies/*.md files, or state explicitly that they live in the parent skill-suite directory so navigation is not broken within the bundle.

In the description, narrow the broad trigger terms ("discovery", "taxonomia", "arquitetura de informação") to the research context (e.g. "card sorting / taxonomia de conteúdo") to reduce overlap with skills 02 and 21.

DimensionReasoningScore

Conciseness

The body is dense and directive with no generic filler (no explaining what UX is to Claude), and soft-skill content is compressed into heuristics. Minor over-length: illustrative anecdotes (lanterna no porão, caso QR Code) and the pipeline positioning repeated across intro, Posicao no Pipeline, Handoff and Integracao could be trimmed. Not 5 because of these trimmable passages; not 3 because padding is minor, not 'some unnecessary explanation'.

4 / 5

Actionability

Concrete, ready-to-use guidance throughout: a method-selection table mapping question type to method, specific recruiting numbers ("teste com 3-5 usuários"), a defined synthesis output ("3 bullet points"), a citability checkpoint ("apontar de qual entrevista/métrica/observação especificamente ela veio — se não conseguir apontar... Reescrever ou remover"), and verified reference files holding actual templates. For an instruction-only skill this fully covers the common cases.

5 / 5

Workflow Clarity

The 6-step Protocolo is clearly sequenced (definir problema → escolher método → conduzir → sintetizar → produzir artefato → gates + handoff) with explicit validation: the step-5 Checkpoint has a fix-and-redo loop ("Reescrever ou remover a afirmação antes de entregar"), step 6 runs integrity/anti-AI gates, and 'Evidencia de Conclusao' is a completion checklist. Feedback loops for error recovery are present.

5 / 5

Progressive Disclosure

The body is a genuine overview: three one-level-deep references, each real on disk, annotated with scope and loaded on demand ("Carregar apenas a referência que o entregável pedido exige"), and sintese-tematica.md itself states when to use it instead of the default step 4. Not 5 because the body references `GLOBAL.md` and five `policies/*.md` paths that are not present in this bundle, leaving dangling navigation targets; not 3 because all in-bundle references are well-signaled and appropriately split.

4 / 5

Total

18

/

20

Passed

Description

96%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: it enumerates concrete capabilities, provides a comprehensive bilingual trigger list with synonyms, and explicitly answers both 'what' and 'when'. The only weakness is a handful of broadly-shared terms (discovery, taxonomia) that create minor overlap risk with adjacent skills in the suite.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions with comprehensive coverage of the domain: "entrevista com usuário, criação de persona baseada em pesquisa, mapa de jornada (journey map), teste de usabilidade qualitativo, arquitetura de informação, card sorting e validação de problema". Not 4: the capability list covers essentially the full qualitative-research workflow rather than having minor gaps.

5 / 5

Completeness

Explicitly answers both what (the enumerated capability list) and when via the equivalent of a 'Use when' clause: "Trigger em: 'pesquisa com usuário', 'user research', ..." with concrete trigger phrases. Not 4: the 'when' is fully explicit with a concrete trigger list, not merely present-but-imprecise.

5 / 5

Trigger Term Quality

Comprehensive natural terms with synonyms in both Portuguese and English: "pesquisa com usuário", "user research", "UX research", "discovery", "mapa de jornada", "journey map", "teste de usabilidade", "usability testing", "criar persona", "focus group". These are exactly the phrases a user would say when needing this skill; not 4 because synonym coverage is near-exhaustive for the domain.

5 / 5

Distinctiveness Conflict Risk

The niche is clear (qualitative UX research) and it explicitly positions itself against adjacent skills ("Antecede o PO (01) e o UI/UX (02)"), but a few triggers like "discovery", "taxonomia" and "arquitetura de informação" overlap with closely related skills in the same suite (ui-ux-design 02, data-analytics 21). Not 5 due to this minor overlap risk; not 3 because the majority of triggers ("entrevista em profundidade", "card sorting", "teste de usabilidade", "focus group") are unambiguous.

4 / 5

Total

19

/

20

Passed

Validation

87%

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

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

metadata_version

'metadata.version' is missing

Warning

Total

14

/

16

Passed

Repository

felvieira/claude-skills-fv

Path

skills/51-ux-research/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.