discovery-interview
Conduct an interactive discovery interview to produce a structured product specification. Triggers: write a spec, PRD, feature spec, requirements, product requirements, scope a project, brainstorm a feature, flesh out an idea, plan a new project. Uses AskUserQuestion for all user choices; WebSearch/WebFetch when the user wants research. Outputs: user stories, acceptance criteria, technical constraints, prioritized requirements in docs/specs/ per SPEC_TEMPLATE.md. Do NOT use for: implementation, code review, debugging, refactors, or when the user already has a complete spec they only want edited.
95
100%
Does it follow best practices?
Impact
77%
1.08xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Quality
Discovery
100%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 an excellent skill description that hits all the marks. It provides specific actions and outputs, comprehensive natural trigger terms, explicit 'what' and 'when' guidance, and clear boundaries via a 'Do NOT use for' clause. The description is concise yet thorough, making it easy for Claude to correctly select this skill from a large pool.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'interactive discovery interview', 'structured product specification', 'user stories, acceptance criteria, technical constraints, prioritized requirements'. Also specifies tools used (AskUserQuestion, WebSearch/WebFetch) and output location (docs/specs/ per SPEC_TEMPLATE.md). | 3 / 3 |
Completeness | Clearly answers both 'what' (conduct interactive discovery interview to produce structured product specification with user stories, acceptance criteria, etc.) and 'when' (explicit trigger list). Also includes a 'Do NOT use for' clause which further clarifies boundaries and aids selection. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'write a spec', 'PRD', 'feature spec', 'requirements', 'product requirements', 'scope a project', 'brainstorm a feature', 'flesh out an idea', 'plan a new project'. These are highly natural phrases a user would actually type. | 3 / 3 |
Distinctiveness Conflict Risk | Very clearly scoped to product specification/PRD creation via interactive interview. The explicit 'Do NOT use for' clause (implementation, code review, debugging, refactors, editing existing specs) sharply distinguishes it from coding, review, and editing skills, making conflicts unlikely. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a high-quality skill that efficiently communicates a complex multi-phase interview process. It excels at providing concrete examples (AskUserQuestion calls, WebSearch queries) while keeping the overview concise and delegating details to companion files. The workflow is well-structured with explicit validation gates and anti-patterns that reinforce correct behavior.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. It avoids explaining what specs, PRDs, or interviews are. Every section serves a purpose—non-negotiables, process table, anti-patterns—with no padding or unnecessary context. The examples are minimal but illustrative. | 3 / 3 |
Actionability | Provides concrete AskUserQuestion call examples with exact syntax, a specific WebSearch example with realistic query, explicit file output path pattern (docs/specs/YYYY-MM-DD-<name>.md), and clear minimum thresholds (10-15 questions). The guidance is specific and directly executable. | 3 / 3 |
Workflow Clarity | Seven phases are clearly sequenced in a table with explicit ordering requirement. Validation is built in via Phase 5 completeness check that must pass before proceeding, plus a confirmation step before spec generation. The 'Integrated flow' section provides a concise summary of the full sequence with feedback loops (research loop, conflict resolution). | 3 / 3 |
Progressive Disclosure | Excellent progressive disclosure: the SKILL.md serves as a clear overview with non-negotiables and process summary, while detailed phase instructions are delegated to well-organized companion rule files via one-level-deep references. The spec template is also referenced separately. Navigation is clear via the table linking phases to specific anchors in companion files. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- kvokov/oh-my-ai
- Commit
29ba45a
- 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.