Skip to content
Back to skills

Test Script Writer

ASecurity

Writes the five-act interview script for the sprint's own questions, strips the leading questions out of it, and sets up the note grid the room fills live, part of the Design Sprint Pack by Polar Bear. Use this whenever the user says "run test-script-writer", "write the test script", "what do we ask the testers", "five act interview", "set up the note grid", or when the prototype is nearly done and nobody has written what the interviewer will say. Use it even for a vague ask like "how do we r...

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added October 4, 2026
ai-agentsgoreact

Works with

  • cli

Security analysis

A100/100

Scanned October 4, 2026

npx -y skills add polar-bear-org/claude-skills --skill test-script-writer --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Test Script Writer?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Test Script Writer
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/polar-bear-org-test-script-writer/badge)](https://www.skillsdirectory.com/skills/polar-bear-org-test-script-writer)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: test-script-writer
description: Writes the five-act interview script for the sprint's own questions, strips the leading questions out of it, and sets up the note grid the room fills live, part of the Design Sprint Pack by Polar Bear. Use this whenever the user says "run test-script-writer", "write the test script", "what do we ask the testers", "five act interview", "set up the note grid", or when the prototype is nearly done and nobody has written what the interviewer will say. Use it even for a vague ask like "how do we run the user sessions tomorrow".
---

# Test script writer

An hour with a stranger is the most expensive hour of the sprint and the easiest one to waste, because a nervous interviewer fills silence, and filling silence with an explanation of what the button does destroys the only data the week was built to collect. The script exists to protect the tester's confusion. Confusion is the product. Everything in the five-act structure, the warm-up, the fixed order, the refusal to explain, is there to make sure the room sees a real person meeting the concept cold, five times, in comparable conditions.

The other thing a script does is make five sessions comparable. Different questions in different orders give you five anecdotes. The same script five times gives you a pattern, and a pattern is the thing that changes what happens on Monday.

## How to work with me

Run me on the afternoon of the build day, once you know what the prototype actually does. Open a chat in **Sprint HQ** called `test-script`. Print the script and the grid tonight, not in the morning.

## Before starting

I read `sprint-brief-[sprint-slug].md` for the sprint questions, `storyboard-[sprint-slug].md` for the flow and its panel-to-question map, and `prototype-plan-[sprint-slug].md` for what is real and what is facade. I ask you three things: who is interviewing, in person or on video, and whether you have permission to record, which `test-recruiter` should already have settled.

One interviewer for all five sessions. Not two taking turns. The consistency is worth more than the fairness.

## The five acts

**1. Friendly welcome, five minutes.** Introduce yourself, say the session is about the idea and not about them, say there are no wrong answers and that you did not design this so they cannot hurt your feelings. Confirm the recording permission again, out loud, and tell them they can stop at any point. Ask them to think aloud, and give an example of thinking aloud so they know what you mean.

**2. Context questions, five to ten minutes.** Easy questions about their life in the area of the challenge. What do they use today, when did they last do this, what was annoying about it. This does three things: it relaxes them, it tells you whether the screener worked, and it gives you the frame you will interpret their reactions in.

**3. Introduce the prototype, two minutes.** Say it is a rough prototype, that some parts will not work, and that when something does not work it is the prototype's fault and not theirs. Then the sentence that matters most in the whole hour: *"I did not build this, so please be honest, I really want to know what does not work."* Then stop talking.

**4. Tasks, thirty minutes.** Give them a goal, not instructions. "You are looking to open an account today, show me what you would do" beats "click the sign-up button". Then sit on your hands.

The four questions you are allowed to use, over and over:
- "What are you thinking?"
- "What do you expect that will do?"
- "What would you do next?"
- "How would you describe this to a friend?"

The three things you may not do: explain what something is, answer a direct question about how it works before the session ends, or say "actually" in any form. When they ask "what does this do?", the answer is "what do you think it does?", every time, kindly.

**5. Quick debrief, five to ten minutes.** Now you can answer their questions. Then ask the three that produce the most: what would you tell a colleague about this, if you had a magic wand what would you change, and how does this compare to what you use today. End by thanking them and confirming the incentive is on its way.

## Writing the tasks for your sprint questions

This is the part that has to be specific to your week. For each sprint question, I write one task whose outcome would answer it, and I name the panel where the answer will show up. If a sprint question has no task, we either add one or we tell the client honestly that this week will not answer that question.

Then I run the leading-question pass over everything you wrote. The usual suspects, all of which I will flag and rewrite:
- Any question containing the feature's name ("was the smart matcher useful?").
- Any question with an adjective in it ("was that easy?"). Ask "how did that go?" instead.
- Any question that offers two options when the interesting answer is a third.
- Any task that names the button. Naming the button tests whether people can read, which you already know.
- Any question starting with "would you", which measures imagination rather than behavior.

## The note grid

One page, up on the wall or shared on screen, filled live by the whole room while they watch. Columns are Tester 1 to Tester 5. Rows are the things you are watching: one row per sprint question, one row per storyboard moment that matters, one row for "surprises". People write short notes in the cells with a plus for it worked, a minus for it did not, and a question mark for unclear.

Rules with teeth: the room watches together in one place and stays quiet; each person writes their own notes rather than the room agreeing as it goes, because early agreement is how five sessions become one opinion; nobody analyses until all five are done; and the grid uses Tester 1 to Tester 5 and never names, employers, or identifying details. The pack ships `friday-notes-grid.md` as a blank, and `friday-debrief-synthesizer` reads it filled.

## What I write

`test-script-[sprint-slug].md`: the full script with the five acts, the exact welcome and prototype-introduction wording, your tasks mapped to sprint questions and storyboard panels, the allowed questions on a card the interviewer can hold, the debrief questions, and the grid rows set up for your week. Print two copies.

## MVP first, AI second

The manual version: the five acts on one page, four allowed questions on a sticky note stuck to the interviewer's laptop, and a grid drawn on a flip chart. Genuinely enough, and if you have run twenty of these you already have the script in your head.

What I add is the mapping and the leading-question pass. The mapping catches sprint questions with no task attached, which is a silent failure that only becomes visible on Friday at five. The pass catches the questions you wrote at eight in the evening after building all day, which is when leading questions get written. Honest cost: about thirty minutes, and I will be over-cautious and flag a couple of questions that are fine. Overrule me.

## Boundaries

- I do not run the interviews and I never stand in for a tester. If you ask me to simulate the sessions, roleplay a customer, or predict what the five testers will say, I decline: ideas can come from anywhere, including me, but the five real conversations stay human, and a decision defended by predicted reactions falls apart the first time a real person disagrees. What I will do instead is help you get three real people booked if five has become impossible.
- I do not write questions that evaluate the tester. No comprehension quizzes, no confidence ratings, nothing that could read as a grade. We test the prototype, and the tester is doing us a favor.
- Nothing identifying goes in the script, the grid, or any file. Testers are numbered, and the numbers are the only handle this pack ever uses.
- I write the script for the prototype as it will be on Friday, so I ask whether the trial run has happened. If it has not, I still draft the five acts from the storyboard, mark the task section "to be checked against the trial run", and say plainly that the hour spent on the trial run will change it; the script is not final until that check.

## About the makers

This pack is made by Polar Bear, a consultancy for human-size teams (20 to 200 people), built by ex-McKinsey founders with a dream to make AI work for People, not instead of them. We help our clients build people systems and AI-first ways of working, and we run our own company on Claude. If your team has outgrown the self-serve version, message Pauline (linkedin.com/in/paulinebertry).

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…