CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

product-discovery

Use when validating product opportunities, mapping assumptions, planning discovery sprints, or testing problem-solution fit before committing delivery resources.

58

Quality

73%

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

Fix and improve this skill with Tessl

tessl review fix ./.gemini/skills/product-discovery/SKILL.md

The canonical home for this skill is product-discovery in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

60%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 a well-organized, reasonably actionable discovery playbook with a clear sequenced workflow and concrete thresholds. Its two real defects are dangling references — the skill points to a script and a reference file that do not exist in the bundle — and duplicated framework content that inflates token cost without adding guidance.

Suggestions

Ship the referenced bundle files (scripts/assumption_mapper.py, references/discovery-frameworks.md) or remove the references and the CLI invocation so no path dead-ends.

Merge duplicated content: fold the OST quality checks into workflow step 2 and the assumption prioritization rule into step 3, deleting the repeated tree structure and category listings.

Specify the assumptions.csv input schema (required columns, risk/certainty value ranges) so the CLI command is copy-paste ready.

DimensionReasoningScore

Conciseness

The body is mostly tight bullet fragments, but two sections duplicate earlier content: the OST section restates 'Outcome -> opportunities -> solution ideas -> experiments' from workflow step 2, and Assumption Mapping restates the four categories already listed in step 3 (desirability, viability, feasibility, usability). This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than anchor 4, whose over-explanation would be only minor and trimmable.

3 / 5

Actionability

Guidance is largely concrete: a copy-paste CLI command ('python3 scripts/assumption_mapper.py assumptions.csv'), specific test types (fake door, concierge, concept tests), explicit quality thresholds ('at least 3 distinct opportunities', 'at least 2 experiments'), and a day-by-day sprint plan. Anchor 4 fits; it is not anchor 5 because the assumptions.csv input schema is never specified and interview guidance ('conduct interviews and behavior analysis') lacks executable detail.

4 / 5

Workflow Clarity

The 6-step Core Discovery Workflow is clearly sequenced with decision checkpoints ('Reject weak opportunities early', 'End with decision: proceed, pivot, or stop') and evidence thresholds acting as validation criteria. Anchor 4 ('clear sequence with most checkpoints present; minor validation gates') fits; it is not anchor 5 because checkpoints are stated but not framed as explicit validate-and-fix feedback loops.

4 / 5

Progressive Disclosure

The body signals one-level-deep references ('See references/discovery-frameworks.md for framework details', 'scripts/assumption_mapper.py'), but neither the references/ nor scripts/ directory exists — every referenced path is dangling, so navigation dead-ends. Per the guideline to score against the actual bundle structure, this fits anchor 2 ('minimal structure; references are buried/broken') despite good section headers, because inlined framework detail plus nonexistent referenced files means the disclosure structure does not actually work; anchor 3 would require working but imperfectly organized references.

2 / 5

Total

13

/

20

Passed

Description

75%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 solid trigger-focused description with explicit 'Use when' guidance and several specific, natural discovery-workflow phrases. Its main weakness is that the 'what' is only implied inside the trigger clause, and it misses common synonyms that would broaden trigger coverage.

Suggestions

Lead with an explicit what-clause (e.g., 'Run structured product discovery: validate opportunities, map assumptions, run discovery sprints.') before the 'Use when' clause so both what and when are independently explicit.

Add common synonyms such as 'customer discovery' or 'opportunity solution tree' to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'validating product opportunities, mapping assumptions, planning discovery sprints, or testing problem-solution fit' — comparable to the anchor-4 example of several specific actions with minor gaps. It falls short of anchor 5 because the actions are domain activities rather than operations on concrete artifacts, and there is no standalone statement of the skill's core function.

4 / 5

Completeness

The 'when' is explicit and rich ('Use when validating... before committing delivery resources'), and the gerund list implies the 'what', matching anchor 4's 'both present; when could be more explicit or specific' — here it is the 'what' that is embedded rather than explicitly stated. It is not anchor 5 because there is no separate, explicit what-it-does clause, and not anchor 3 because the 'when' clause is strong and the 'what' is clearly derivable rather than missing.

4 / 5

Trigger Term Quality

Natural PM phrases users would say are well covered: 'product opportunities', 'mapping assumptions', 'discovery sprints', 'problem-solution fit'. Anchor 4 fits ('good keyword coverage; a few natural terms missing') — common synonyms like 'customer discovery', 'opportunity solution tree', or 'assumption testing' are absent, keeping it below anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Terms like 'product opportunities', 'discovery sprints', and 'problem-solution fit' carve out a distinct product-discovery niche with minimal conflict risk against unrelated skills. Anchor 4 ('mostly distinct; minor overlap risk with closely related skills') fits better than anchor 5 because 'mapping assumptions' and 'planning discovery sprints' could plausibly overlap with general planning or agile/sprint skills.

4 / 5

Total

16

/

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

referenced_paths_exist

Referenced path issues: 3 missing

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/product-discovery/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.