CtrlK
BlogDocsLog inGet started
Tessl Logo

customer-research

Conduct, analyze, and synthesize customer research including surveys, interviews, and community mining to build personas and uncover jobs-to-be-done.

56

Quality

64%

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 ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/customer-research/SKILL.md

The canonical home for this skill is customer-research in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

63%Scale 1-5

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

This is a solid, well-structured customer research skill that provides genuinely useful frameworks and templates. Its main strengths are the clear two-mode structure, actionable extraction frameworks, and concrete deliverable templates. Its weaknesses are moderate verbosity (some sections explain things Claude would know), a reference to a bundle file that doesn't exist, and content length that could benefit from splitting detailed templates into separate reference files.

Suggestions

Trim explanatory content Claude already knows (e.g., what NPS passives are, that online reviewers skew toward strong opinions) to improve conciseness.

Move the detailed persona template and asset-type extraction details into separate reference files (e.g., references/persona-template.md, references/asset-analysis.md) to improve progressive disclosure.

Either provide the referenced 'references/source-guides.md' file or inline the most critical search operators and platform-specific tips to ensure actionability doesn't depend on a missing file.

DimensionReasoningScore

Conciseness

The skill is fairly comprehensive but includes some unnecessary explanation that Claude would already know (e.g., explaining what NPS passives/detractors are, explaining that online reviewers skew toward power users). The persona anti-patterns section and some of the extraction framework explanations could be tightened. However, much of the content is genuinely useful domain-specific guidance rather than basic concept explanation.

3 / 5

Actionability

The skill provides concrete frameworks, templates, and structured extraction approaches. The persona structure template, research synthesis template, and extraction field tables are directly usable. However, it lacks executable code or specific search operator examples (it references 'references/source-guides.md' for those), and some guidance remains at the instructional level rather than copy-paste ready.

4 / 5

Workflow Clarity

The two-mode structure is clear, and the synthesis steps provide a logical sequence. The 'Questions to Ask Before Proceeding' section establishes a good starting workflow, and the confidence-level labeling acts as a validation checkpoint. However, there's no explicit feedback loop for validating research conclusions with the user before building deliverables, and the overall end-to-end flow between modes could be more explicitly sequenced.

4 / 5

Progressive Disclosure

The skill references 'references/source-guides.md' for detailed platform playbooks, which is good progressive disclosure. However, no bundle files are provided, so we can't verify that reference exists. The skill itself is quite long (~250+ lines) and some content like the full persona template and detailed asset-type guidance could potentially be split into reference files. The related skills table at the end is well-structured for navigation.

3 / 5

Total

14

/

20

Passed

Description

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

The description does a good job listing concrete research methods and deliverables, making it reasonably specific and distinctive. Its main weakness is the lack of an explicit 'Use when...' clause, which limits Claude's ability to know exactly when to select this skill. Adding a few more trigger term synonyms (e.g., 'user research', 'JTBD') would also improve discoverability.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about customer research, building personas, understanding user needs, or identifying jobs-to-be-done.'

Include common synonyms and variations such as 'user research', 'JTBD', 'customer discovery', 'market research', and 'user interviews' to improve trigger term coverage.

DimensionReasoningScore

Specificity

Lists several specific actions: 'conduct, analyze, and synthesize customer research' along with concrete methods (surveys, interviews, community mining) and outputs (personas, jobs-to-be-done). Minor gaps—doesn't elaborate on what 'community mining' entails or other deliverables.

4 / 5

Completeness

The 'what' is clearly stated with concrete actions and outputs, but there is no explicit 'when' clause (e.g., 'Use when...'). The absence of a 'Use when' trigger guidance caps this at 3 per the rubric guidelines.

3 / 5

Trigger Term Quality

Includes strong natural keywords like 'customer research', 'surveys', 'interviews', 'personas', and 'jobs-to-be-done'. Missing some common synonyms or variations like 'user research', 'JTBD', 'user interviews', 'customer discovery', or 'market research' that users might naturally say.

4 / 5

Distinctiveness Conflict Risk

Fairly distinct with its focus on customer research methods and specific outputs like personas and jobs-to-be-done. Minor overlap risk with general market research or UX research skills, but the combination of methods and deliverables creates a reasonably clear niche.

4 / 5

Total

15

/

20

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
administrakt0r/AI-Agents-Safe-Coding-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.