Empty State Writer Skill

An empty state is the most-missed onboarding moment: the user arrives and there's nothing there. Done well, it explains the value, removes confusion, and offers the one action that fills the screen. This skill writes empty states that teach and activate — not blank voids or generic "No data" labels.

Working from a brief

Given "the empty state for a projects list", write it anyway — infer why the screen is empty, the value of the feature, and the best first action, labelling assumptions. Cover the distinct empty-state types that apply. Never hand back a question instead of copy.

Required Inputs

Ask for these only if they aren't already provided (else infer and label):

• The screen/feature — what normally lives here and its value to the user.
• Why it's empty — first use, the user cleared/completed everything, a search/filter returned nothing, or no access.
• The primary action — what you want them to do (create, connect, invite, import, adjust filters).
• Voice & constraints — tone, and any space/illustration limits.

Output Format

Empty States: [screen]

Write the relevant types (skip those that don't apply):

• First use (no data yet) — headline (the value/outcome), a line on what to do and why it's worth it, and a primary CTA (+ optional secondary like "Learn more" / "Import").
• User-cleared / all done — a positive, reassuring message (inbox zero, all tasks complete) — celebrate, don't alarm.
• No search/filter results — say nothing matched, and offer a way forward (clear filters, broaden, create it).
• Error / no permission — what's wrong and the next step (retry, request access, contact admin) — calm and blame-free.

For each: Headline · Supporting line · Action(s), plus a one-line note on the intended tone/illustration.

Quality Checks

• First-use state explains the value and offers one clear primary action — not just "No items"