CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

persona-research

Use when the user wants consumer or user research with AI personas — virtual customer interviews, focus groups, concept tests, persona building from uploaded materials, a reusable persona panel, or follow-up questions to a specific persona in an existing study.

Quality

89%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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-engineered orchestration skill: lean operational body with all detail domains pushed to clearly signaled one-level references, fully concrete tool calls and a copy-paste-ready sub-agent dispatch snippet, and a six-phase workflow with explicit validation checkpoints, self-checks, and failure-handling feedback loops. The only room for improvement is tightening a few overloaded run-on sentences and reducing repetition of the round-ceiling rules.

DimensionReasoningScore

Conciseness

The ~200-line body contains essentially no explanation of concepts Claude already knows — every line is operational (tool names, event names, paths, limits), and detail is pushed to reference files. However, a few very long run-on sentences (e.g., Phase 1 step 3's single sentence covering all 【研究设置】 settings, and Phase 2 step 2's plan-field list) and repeated statements of the 20-round ceiling (in the Cost Limits table, plan.md fields, and the sub-agent prompt) could be tightened. This matches anchor 4 (efficient with minor instances that could be trimmed) better than anchor 3, and it lacks the padding that would pull it lower.

4 / 5

Actionability

Guidance is fully executable: exact tool calls with events and arguments ("call `update_study` event `plan_confirmed` ... with `interview_rounds: 20`"), exact file paths in the directory layout, a copy-paste-ready Python snippet for dispatching `persona-interviewer` sub-agents with a complete self-contained prompt template, and concrete [Wrong]/[Right] persona examples. Tool calling details deferred to reference/tools.md are explicitly routed ("Read it before the first call in a conversation"), matching anchor 5's fully executable, common-case-covering standard.

5 / 5

Workflow Clarity

Six phases are clearly sequenced with numbered steps and explicit validation checkpoints: the guide self-check "before showing the plan" with a required before -> after changelog, the persona self-check, the `check_interviews` -> re-dispatch continuation -> re-check feedback loop for unfinished transcripts, the delivery check "before publishing", and defined behavior on timeout, skip, refusal, and interruption ("When a step stops ... send no event"). This matches anchor 5 (explicit validation steps, feedback loops for error recovery, checklists for complex processes); nothing reduces it to anchor 4, since even failure paths are specified.

5 / 5

Progressive Disclosure

The body is an orchestration overview with a dedicated "References (Read On Demand)" section that lists each reference file with a summary of its contents and an explicit read trigger (e.g., tools.md "Read it before the first call in a conversation"; persona-portraits.md "read ... first, then call `assign_persona_portraits`"). References are one level deep and clearly signaled, and detail domains (methods, tool contracts, report writing, charts, templates) are appropriately split out — matching anchor 5. No bundle files were present in the review workspace to verify the referenced paths on disk, so this score reflects the reference structure as written. One inline reference (persona-portraits.md) sits mid-workflow rather than in the section, but it is clearly signaled and does not impair navigation.

5 / 5

Total

19

/

20

Passed

Description

83%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, trigger-first description that names six concrete persona-research capabilities with explicit use-when guidance and highly specific follow-up triggers. Its only weaknesses are minor: it does not mention the report and real-person validation deliverables, and the broad 'user research' framing has slight overlap risk with a general research skill.

DimensionReasoningScore

Specificity

The description enumerates six concrete capabilities — "virtual customer interviews, focus groups, concept tests, persona building from uploaded materials, a reusable persona panel, or follow-up questions to a specific persona" — which is specific, but it omits the skill's major deliverables named in the body ("an evidence-backed report" and a real-person validation questionnaire), leaving minor coverage gaps. It sits between anchor 4 (several specific actions, minor gaps) and anchor 5 (comprehensive coverage), and the omission of two headline outputs keeps it at 4 rather than 5; it is clearly above anchor 3 (only 1-2 concrete actions).

4 / 5

Completeness

It explicitly answers "when" with a direct trigger clause — "Use when the user wants consumer or user research with AI personas" — and answers "what" through the concrete enumerated activities (interviews, focus groups, concept tests, persona building, panel, follow-ups). This matches the anchor-5 pattern of both what and when with concrete trigger phrases in one explicit statement, exceeding anchor 4 where the "when" is only adequate.

5 / 5

Trigger Term Quality

Natural phrases users would say are well covered: "consumer or user research", "AI personas", "virtual customer interviews", "focus groups", "concept tests", "follow-up questions". A few common variants are missing (e.g., "survey", "customer feedback", "simulate customers"), so it matches anchor 4 (good keyword coverage, a few natural terms missing) rather than anchor 5's comprehensive synonym coverage, while being clearly above anchor 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is well defined by "AI personas", "virtual customer interviews", and "follow-up questions to a specific persona in an existing study", but the opening scope "consumer or user research" has minor overlap risk with a closely related general research skill (the body itself borrows from a deep-research skill in the same environment). Anchor 4 (mostly distinct, minor overlap with closely related skills) fits better than anchor 5, and it is far above the generic overlap of anchors 2-3.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 7 missing

Warning

Total

15

/

16

Passed

Repository

dtyq/magic

Path

backend/super-magic/agents/skills/persona-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.