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

  1. Sign in as a fresh account, or clear the data, so the state is genuinely empty.

  2. Land on the screen the way a new user would, through the nav, not by URL.

  3. Sit on it and read out what it currently tells you to do.

  4. 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 downRecording it instead
Knowing what new users seeAssumed.Recorded, which is usually a surprise.
The copy changeWritten in a ticket, out of context.Written against the screen the agent can see.
Keeping the product's voiceDrifts 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.