plugins/v1tamins/skills/v1-testing-prototypes/SKILL.md
Use when planning or synthesizing user tests for prototypes, mockups, clickable demos, product concepts, design flows, landing pages, or early product specs. Triggers on "test this prototype", "prototype testing", "user test plan", "validate this product idea", "test with users".
npx skillsauth add v1-io/v1tamins v1-testing-prototypesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Plan and synthesize prototype tests that reveal whether a product idea is valuable, usable, and feasible before engineering commits to building it.
Default output:
## Prototype Test Plan
### Objective
[What must be learned before build/ship decisions.]
### Target Users
[Primary users, excluded users, and screener criteria.]
### Tasks
| Task | What It Tests | Success Signal | Watch For |
| --- | --- | --- | --- |
### Value Questions
[Questions asked after use, not before, to test whether users care.]
### Facilitation Rules
[How to avoid leading, rescuing, or turning the session into design critique.]
### Evidence Capture
[Observation format, severity scale, and synthesis table.]
### Decision Gate
[Proceed, iterate, retest, or shelve.]
If the user already ran sessions, produce a synthesis instead: findings, evidence, severity, next prototype changes, and whether another round is needed.
Start with the decision the prototype test should support:
Do not run a generic preference test. Prototype testing is for evidence that changes product decisions.
Review the artifact before writing the plan:
If no artifact exists, produce a testable-prototype checklist before a user-test plan.
Cover the three risks separately:
| Risk | Test Method | Evidence | | --- | --- | --- | | Value | Users care after seeing/using the prototype | Pull, willingness to switch/pay/recommend, emotional reaction, urgency | | Usability | Users can complete key tasks without help | Task completion, hesitation, wrong turns, abandonment, language mismatch | | Feasibility | The team can build the needed behavior | Engineer review, risky assumptions, integration/data/performance constraints |
Do not treat stated preference as value evidence. Watch what users do, then ask why.
Write a short screener that filters for the real target user:
Prefer a small number of high-fit users over many weak-fit users.
Tasks should put users in use mode:
Avoid questions like "What would you change?" until after observed use. Design suggestions are secondary to evidence of comprehension, value, and behavior.
Use these rules during sessions:
Ask value questions after the participant has experienced the prototype:
Use numeric scales only when they help compare rounds. Always capture the explanation behind the number.
Use this synthesis table:
| Finding | Evidence | Risk Type | Severity | Prototype Change | Retest? | | --- | --- | --- | --- | --- | --- |
Severity:
Separate:
Recommend one next action:
As a practical heuristic, when several consecutive target users understand the value and complete the key tasks without help, the prototype is usually ready for the next build decision. Do not require artificial statistical certainty for qualitative discovery work.
v1-e2e-testing for built product flows.v1-interview-me first when the idea is too vague to define a prototype objective.v1-prd after prototype evidence supports a build decision.v1-strategy-review when the prototype test raises broader product or business tradeoffs.v1-e2e-testing after the prototype becomes implemented product behavior.development
Use when creating a polished self-contained HTML page would help the user understand, compare, review, present, tune, or interact with information better than Markdown. Triggers on "make an HTML page", "HTML artifact", "nice HTML", "visual report", "interactive explainer", "one-page dashboard", "shareable page".
data-ai
Use when turning a textbook, PDF, blog post, article, paper, course, notes, transcript, or other source material into suggested agent skills or skill improvements. Triggers on "what skills could come from this", "extract skills from", "turn this into skills", "skill ideas from this source".
development
Run an extremely strict maintainability review for abstraction quality, giant files, and spaghetti-condition growth. Use for large prs, new features/architectures, a deep code quality audit, or especially harsh maintainability review.
testing
Commit, push, open, and land a pull request through CI handoff. Use when work is complete and the user wants an agent to create or update a PR, open it as a draft, monitor GitHub checks with `gh pr checks`, fix failed checks, retry up to three remediation pushes, mark the PR ready for review once green, and move a linked Linear ticket to Human Review when one exists. Trigger on requests like 'land this PR', 'open and monitor a PR', 'commit push and watch CI', 'get this ready for review', or 'finish the PR workflow'.