agentleFS
teodstrteodstr/garage/skills/prototype-testing/SKILL.md

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".

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
  1. Very specific:

    Before building the interface of an MVP (mvp-scoping), or to compare two flows.

    line 20
  2. Very specific:

    After a landing-page has shown interest, to check that people can use what they asked for.

    line 21
  3. Distinctive:

    Not to measure demand or prices: a usability test shows whether people can use something, not whether they will pay for it.

    line 22

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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-page has 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

  1. The core job and the two or three tasks a user must complete.
  2. The target users and how to recruit five of them.
  3. Brand elements if they exist.

Method

  1. 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."
  2. 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.
  3. Recruit five users from the target, not colleagues. Plan a second round of five new users after the fixes.
  4. 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.
  5. 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.
  6. Fix and test again: change the prototype for the severe problems and run the next round.
  7. 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

EnglishFrançaisEspañol
PrototypePrototype, maquettePrototipo, maqueta
Usability testTest d'utilisabilitéPrueba de usabilidad
Think-aloudPensée à voix hautePensamiento en voz alta
WireframeWireframe, maquette fil de ferWireframe, esquema de pantalla
Task success rateTaux de réussite des tâchesTasa de éxito de las tareas
SeverityGravitéGravedad

Sources

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.