Create detailed user persona with guided questions
43
30%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/product-design/skills/create-persona/SKILL.mdQuality
Discovery
32%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 identifies a specific task (user persona creation) but is too brief to be effective for skill selection. It lacks explicit trigger guidance, comprehensive capability details, and natural keyword variations that users might employ when requesting this type of work.
Suggestions
Add a 'Use when...' clause with trigger terms like 'persona', 'target user', 'customer profile', 'buyer persona', 'user research', or 'audience analysis'
Expand the capabilities to specify what the persona includes (demographics, goals, pain points, behaviors, etc.) and what outputs are generated
Include common variations of terminology users might use such as 'customer avatar', 'ideal customer profile', or 'UX persona'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names a specific domain (user persona creation) and one action (guided questions), but lacks comprehensive detail about what the persona includes or what specific outputs are generated. | 2 / 3 |
Completeness | Describes what it does (create persona with guided questions) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Contains 'user persona' which is a relevant keyword, but misses common variations like 'customer profile', 'target audience', 'buyer persona', 'user research', or 'UX persona'. | 2 / 3 |
Distinctiveness Conflict Risk | User persona is a reasonably specific niche, but could overlap with general UX research skills, interview guide skills, or customer research skills without clearer boundaries. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
27%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is essentially a stub that delegates all meaningful content to an external template file. It fails to provide the 'guided questions' promised in the description and offers no actionable guidance for creating personas. The skill would be significantly improved by including the actual persona creation process inline or at minimum showing the template structure and key questions.
Suggestions
Include the actual persona template content or at least the key guided questions inline in the skill, rather than just pointing to an external file
Add concrete examples of what a completed persona looks like (input questions -> output persona)
Specify what 'template variables' exist and how they should be replaced with actual values
Add validation steps to verify the generated persona file is complete and well-formed
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is relatively brief but includes some redundancy (e.g., 'Read the source file' and 'Source Content Location' sections repeat the same path). The structure is reasonable but could be tighter. | 2 / 3 |
Actionability | The skill provides vague direction ('follow the documented process exactly') without showing what that process actually is. No concrete code, no template content shown, and the actual persona creation logic is entirely deferred to an external file. | 1 / 3 |
Workflow Clarity | Steps are listed (1-5) but they're generic file operations without validation checkpoints. Step 5 'Replace any template variables if needed' is vague - what variables? What replacements? No error handling or verification mentioned. | 2 / 3 |
Progressive Disclosure | The skill is essentially a pointer to another file with no substantive content of its own. The 'guided questions' mentioned in the description are nowhere to be found - all actual content is deferred to the template file, making this skill nearly useless on its own. | 1 / 3 |
Total | 6 / 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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
0ebe7ae
Table of Contents
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.