MAKE IT LOOK RIGHT
Turn an empty state into something worth looking at
Empty states are designed once, early, by someone who already knows the product, and then never looked at again by anyone who does not. Recording one from a genuinely empty account is a useful shock, and it gives the agent the real screen rather than the one in your head.
Quick answer
To improve an empty state, record what a fresh account actually sees, read out what the screen tells you to do, and say the one action a new user needs. Paste the Clipy link into your AI agent, such as Claude Code, Codex or Cursor. It rewrites the copy, layout and call to action together, in the voice used elsewhere in your product.
Product walkthrough. Tap for sound.
What to record
Sign in as a fresh account, or clear the data, so the state is genuinely empty.
Land on the screen the way a new user would, through the nav, not by URL.
Sit on it and read out what it currently tells you to do.
Say what a new person actually needs here: the one action, and what would make them take it.
Say this while you record
Say the single action you want them to take. Empty states fail by offering three.
The prompt to paste
Replace the link with your own recording's share URL, then paste this into Claude Code, Cursor, Codex, or whichever agent you connected.
Read https://clipy.online/video/<id> It shows the empty state a new user sees, and what I want it to do instead. Tell me what the screen currently offers and what I said the one action should be. Then rewrite it in this repo: the copy, the layout and the call to action. Match the voice used elsewhere in this product rather than writing generic product copy, and keep it to one primary action.
"Match the voice used elsewhere" is doing real work here. Without it you get empty state copy that reads like every other empty state.
What the agent gets from that link
A summary of what happened
A short written account of the recording, so the agent starts with the shape of the request rather than a wall of raw text.
A timestamped transcript
Your narration with times against it, when audio was captured and processed. This is where your reasoning lives, and it is usually the part that decides whether the agent fixes the right thing.
Key moments with frames
Selected instants from the recording with an image of the screen at that point, so the agent can look at the state you were describing instead of guessing at it.
Pointer and click evidence
Where you clicked and what you were pointing at, with the control's accessibility label when the capture recorded one. It turns "this button" into a specific element.
What changes
| Writing it down | Recording it instead | |
|---|---|---|
| Knowing what new users see | Assumed. | Recorded, which is usually a surprise. |
| The copy change | Written in a ticket, out of context. | Written against the screen the agent can see. |
| Keeping the product's voice | Drifts toward generic. | The agent reads the rest of the product for reference. |
Tips
Connect your agent once
Run the setup at /agent-setup once. After that every Clipy share link works in the same session you are already in.
A seeded account is not an empty state
Recording your own account with forty items in it shows you nothing. Use a fresh account, and if that is hard, that difficulty is itself worth noting.
Do not record the sign-up with real details
Use a test account. The recording captures the form as you fill it in.
Paste the link once the transcript shows
The transcript, summary and key moments appear on the watch page moments after Stop.
Common questions
Is this only for the first-run screen?
No. Search with no results, a filtered list that matches nothing, and an error state are all the same job.
Should I write the copy myself?
Say the idea out loud and let the agent draft it. Rewriting a draft is faster than writing from nothing, and you still decide.
Can the agent see the illustration or icon that is currently there?
It sees it in the key moment frames. It cannot produce a new illustration, but it can tell you the one you have is not carrying the screen.
Other jobs
The same job, elsewhere on Clipy
This page is the job. These cover the same ground for a specific agent, a specific team, or as a tool you can open right now.
The full list is on the use-case index. If your agent is not connected yet, start at agent setup.