hermes

Write a text wireframe spec

Writes a low-fidelity text wireframe for one screen with layout regions, components, content hierarchy, all states and responsive behaviour. Use before visual design or to brief a developer.

context

A wireframe settles structure before anyone argues about colour: what is on the screen, in what order of importance, and how it behaves. Text wireframes are fast to write, easy to review in a pull request or a document, and force decisions that pretty mockups hide: what the screen looks like with no data, with too much data, while loading, and when something fails.

task

Write a low-fidelity wireframe spec for this screen.

screen purpose

Only if [CONTENT] is given:

content

  1. Restate the user, the main task and the single primary action in one or two lines.
  2. Rank the content: what the user must see first, second and third to complete the task. Anything that does not support the task goes to a secondary area or is cut, with the reason.
  3. Draw the layout as a monospace block diagram (boxes from +, - and |) with labelled regions, sized roughly in proportion. For web, draw the desktop layout; for mobile, a single column at about 375 points wide.
  4. Specify each region: its purpose, the components in it (use generic names: table, card, tabs, segmented control, primary button), the content with realistic example values, and its priority.
  5. Specify all five states for the main content: ideal (typical data), empty (first use, and no results after filtering), loading, partial (some data or fields missing), and error (failed to load, failed to save), plus too much data (long text, many items, pagination or virtual scrolling).
  6. Describe responsive behaviour: for web, what changes at tablet and narrow widths (what stacks, collapses or hides, and where hidden things go); for mobile, small screens, large text settings and landscape if relevant.
  7. List interactions: what each action does, where it leads, and what feedback the user gets.
  8. Add accessibility notes: heading structure, landmark regions, focus order, and anything that must not rely on hover or colour alone.
  9. If the purpose is too vague to decide the primary action, ask up to three questions and stop. If only the content is missing, assume realistic content and mark it "assumed".
constraints
  • Stay low fidelity: no colours, fonts or exact pixel values. Use relative sizes and component names.
  • Do not add features the purpose does not need. Put tempting extras in Open questions.
  • Use realistic example content, never lorem ipsum, so that length and density problems show up.
  • Separate what you verified from what you inferred. Mark inferences as such.
  • When you do not know, say "I don't know" once and state what would settle it.
output format

Summary

User, task, primary action.

Layout

The monospace diagram in a code block.

Regions

| Region | Purpose | Components and content | Priority |

States

Ideal, empty, loading, partial, error and too-much-data, each described for the regions it affects.

Responsive behaviour

Interactions

| Element | Action | Result and feedback |

Accessibility notes

Open questions

1 required value still a placeholder; the assistant will ask for it.

details

kind
Prompt: a task you run by name to get one finished thing back
domain
Design
category
UI design
level
Intermediate
made for
Product / UX / UI designer, Product manager, Frontend engineer
risk
read-only
version
v1.0.0 · incubating
reviewed
2026-10-02
works in
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install create-wireframe-spec --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill create-wireframe-spec -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the design plugin
claude plugin install hodios-design@hodios

The plugin brings every entry in this domain at once.

pairs well with

All of UI design
PromptUI design

Critique a UI screen

Critiques one interface screen for hierarchy, layout, consistency, clarity and accessibility against its goal, and returns prioritised, concrete fixes. Use when reviewing a mockup or live screen.

critique-ui-screen
PromptDesign systems

Write a design-system component spec

Writes a design-system component spec covering anatomy, variants, states, behaviour, tokens, content rules, dos and don'ts, and accessibility. Use when adding or documenting a component.

write-component-spec
PromptUI design

Write UX microcopy

Writes interface microcopy (buttons, labels, empty states, errors, confirmations, success messages) that is clear, consistent and in the product's voice. Use when designing or reviewing screens.

write-ux-microcopy
PersonaUI design

Product designer

Product designer who frames the problem before the pixels, explores several options, designs every state and defends decisions with user evidence. Use as a design partner or reviewer.

product-designer
PromptUI design

Adapt a desktop design for mobile

Adapts a desktop screen to mobile by ranking content, choosing layout changes, touch targets and a navigation pattern, and deciding what to drop or defer. Use for responsive products.

adapt-design-for-mobile
PromptUI design

Design a conversational AI interface

Designs a conversational AI interface with entry points, message layout, streaming, citations, error and refusal states, feedback controls and trust cues, specified state by state.

design-chat-interface