This skill should be used when the user says "discover", "product discovery", "arn discover", "help me define this product", "what should I build", "product concept", "define the product", "let's figure out what to build", "vision for this project", "shape this idea", "new project idea", "brainstorm this product", "starting from scratch", or wants to explore and structure a greenfield product idea through guided conversation. Produces a product-concept.md document capturing the product vision, core experience, target users, trust model, platforms, and scope boundaries.
74
68%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/arn-spark/skills/arn-spark-discover/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-constructed description with excellent trigger term coverage and clear completeness, explicitly stating both what the skill does and when to use it. The main weakness is that the concrete actions could be more specific—it describes the output document well but the process is described somewhat abstractly as 'guided conversation' rather than listing discrete steps or capabilities. The description also uses passive/third-person voice appropriately ('Produces a product-concept.md').
Suggestions
Add more specific action verbs describing what the skill does during the discovery process, e.g., 'Guides users through defining target personas, mapping user journeys, identifying trust boundaries, and scoping MVP features' rather than the more abstract 'explore and structure'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (product discovery) and mentions producing a specific document (product-concept.md) with listed sections (vision, core experience, target users, etc.), but the actual actions are somewhat vague—'explore and structure a greenfield product idea through guided conversation' is more process-oriented than listing concrete discrete actions. | 2 / 3 |
Completeness | The description explicitly answers both 'what' (produces a product-concept.md capturing vision, core experience, target users, trust model, platforms, and scope boundaries through guided conversation) and 'when' (extensive list of trigger phrases and the condition 'wants to explore and structure a greenfield product idea'). | 3 / 3 |
Trigger Term Quality | The description includes an extensive list of natural trigger phrases users would actually say, such as 'what should I build', 'brainstorm this product', 'starting from scratch', 'shape this idea', and 'new project idea'. These cover a wide range of natural language variations. | 3 / 3 |
Distinctiveness Conflict Risk | The skill has a clear niche—greenfield product discovery and concept definition—with very specific trigger terms like 'product discovery', 'arn discover', and 'product concept'. The specific output artifact (product-concept.md) further distinguishes it from general brainstorming or project management skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
47%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a comprehensive product discovery workflow with excellent workflow clarity — clear steps, checkpoints, validation loops, and error handling. However, it is severely over-verbose, repeating guidance in multiple formats (narrative + tables) and explaining rationale and conversational strategies that Claude can infer. The content would benefit greatly from being split across reference files, with the main SKILL.md serving as a lean overview rather than a monolithic instruction manual.
Suggestions
Reduce the SKILL.md body by 50-60%: move the detailed checkpoint procedures (A-D), the full agent invocation guide table, and the error handling section into separate reference files, keeping only a concise summary in the main body.
Remove explanatory rationale paragraphs (e.g., 'Why both layers?', the explanation of what product pillars are vs other categories) — Claude can infer these from the instructions themselves.
Eliminate the duplicated agent invocation table at the end — the inline decision table in Step 3 already covers the same information. Choose one format.
Add concrete agent invocation syntax or examples showing exactly how to call the sub-agents (parameter format, expected response structure) rather than describing them abstractly.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~400+ lines. It over-explains conversational strategies, repeats agent invocation guidance in both a workflow section and a separate table, explains rationale that Claude can infer (e.g., 'Why both layers?' paragraph), and includes extensive conditional logic that could be dramatically compressed. Many sections describe what Claude already knows how to do (e.g., how to have a natural conversation, how to acknowledge answers). | 1 / 3 |
Actionability | The skill provides concrete workflow steps, specific agent names, checkpoint triggers, and a decision table for when to invoke agents. However, there are no executable code examples, no concrete agent invocation syntax/API calls, and the actual agent interfaces are described abstractly rather than with copy-paste-ready invocation patterns. The templates are referenced but not shown, and bundle files are not provided. | 2 / 3 |
Workflow Clarity | The multi-step workflow is clearly sequenced (Steps 0-5) with explicit checkpoints (A-D), a readiness check with a status summary, validation loops (user approves/refines at each checkpoint), error recovery paths, and a decision table for situational routing. The fan-out/fan-in orchestration for market research is particularly well-structured with clear phases. | 3 / 3 |
Progressive Disclosure | The skill references external files appropriately (discovery-questions.md, product-concept-template.md, persona-profile-template.md, competitive-landscape-template.md, ensure-config.md) with clear paths, but the SKILL.md itself is monolithic — it inlines enormous amounts of detail that could be split into reference files (e.g., the full checkpoint procedures, the agent invocation guide, error handling). No bundle files were provided to verify references exist. | 2 / 3 |
Total | 8 / 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 | |
1fe948f
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.