prototype-testing
Skill0 starsChanged 2 days agoMITView on GitHub
Build a clickable prototype of a product as a single HTML file and test it with five users: realistic tasks, a think-aloud session script, a findings grid with counts and severity, and the changes to make before building for real. Use to test a product idea, an app flow or a website before coding it. Triggers: "prototype", "clickable prototype", "usability test", "user testing", "mockup", "wireframe", "prototype cliquable", "test utilisateur", "maquette", "test d'utilisabilité", "prototipo", "prueba de usabilidad", "test con usuarios", "maqueta".
In this repository15 other files it gives its agents.
- brand-identitySkill
- competitor-teardownSkill
- customer-interviewsSkill
- desk-researchSkill
- financial-forecastSkill
- first-customersSkill
- funding-optionsSkill
- idea-validationSkill
- landing-pageSkill
- legal-setupSkill
- mvp-scopingSkill
- pitch-deckSkill
- startup-roadmapSkill
- support-programsSkill
- survey-designSkill
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 1 is distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 20
Before building the interface of an MVP (mvp-scoping), or to compare two flows.
- Very specific: line 21
After a landing-page has shown interest, to check that people can use what they asked for.
- Distinctive: line 22
Not to measure demand or prices: a usability test shows whether people can use something, not whether they will pay for it.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Prototype testing
Watching a handful of people use a prototype reveals problems that would otherwise appear after launch, when they cost much more to fix. Nielsen's research suggests that about five users per round uncover most usability problems, so small rounds repeated often beat one large study. This skill builds the prototype, which an agent can do in minutes, and runs a light usability test with it.
When to use
- Before building the interface of an MVP (
mvp-scoping), or to compare two flows. - After a
landing-pagehas shown interest, to check that people can use what they asked for. - Not to measure demand or prices: a usability test shows whether people can use something, not whether they will pay for it.
Inputs
- The core job and the two or three tasks a user must complete.
- The target users and how to recruit five of them.
- Brand elements if they exist.
Method
- Choose the tasks that matter for the core job (sign up, find something, complete a purchase) and write them as scenarios that do not give away the answer: "You want to… Show me how you would do it."
- Build the prototype as one HTML file: realistic content instead of placeholder text, clickable links between the screens, the paths of the tasks working, and the rest clearly marked "not part of this test". Keep the polish light, so that people feel free to criticize it.
- Recruit five users from the target, not colleagues. Plan a second round of five new users after the fixes.
- Run each session (about 30 minutes, in person or by video): ask for consent, explain that the prototype is being tested, not them, and ask them to think aloud. Do not help or explain. Note where they hesitate, make mistakes or give up, and what they say.
- Log the findings in a grid: task, what happened, how many of the five users hit the problem, severity (blocks the task, slows it down, cosmetic) and the likely cause.
- Fix and test again: change the prototype for the severe problems and run the next round.
- Report: the main problems with evidence (quotes and counts), the decisions taken, and what is still unknown.
Output
### Test plan
Tasks: 1. … 2. … 3. … | Users: five people matching <profile> | Success: task completed without help
### Findings
| Task | What happened | Users (out of 5) | Severity | Fix |
|---|---|---|---|---|
### Prototype
<one HTML file, screens linked, realistic content>Quality bar
- Tasks are scenarios that do not reveal the answer.
- Findings give counts out of five and real quotes; no conclusion about demand or price comes from a usability test.
- The prototype uses realistic content and is accessible enough for the people tested.
- Participants gave their consent, and recordings are kept only as long as needed.
- Written in the user's language, with the terms below.
Terminology
| English | Français | Español |
| Prototype | Prototype, maquette | Prototipo, maqueta |
| Usability test | Test d'utilisabilité | Prueba de usabilidad |
| Think-aloud | Pensée à voix haute | Pensamiento en voz alta |
| Wireframe | Wireframe, maquette fil de fer | Wireframe, esquema de pantalla |
| Task success rate | Taux de réussite des tâches | Tasa de éxito de las tareas |
| Severity | Gravité | Gravedad |
Sources
- Nielsen, J. (2000). Why you only need to test with 5 users. Nielsen Norman Group. https://www.nngroup.com/articles/why-you-only-need-to-test-with-5-users/
- Krug, S. (2010). Rocket Surgery Made Easy. New Riders.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

