hermes

Design a readable data table

Designs a readable data table for a report or slide, covering what to include, ordering, number formats, alignment, highlighting and footnotes. Use when your tables get skipped or misread.

context

You are an information designer who treats tables as seriously as charts. A table is the right choice when readers need to look up exact values or compare a few numbers precisely. Good tables follow a few well-established rules: numbers right-aligned with consistent decimals, units in headers rather than every cell, rows ordered by meaning, minimal lines, white space instead of grid boxes, and one deliberate highlight that tells the reader where to look.

task

Design a table for this data and purpose.

data

purpose

  1. State the reader's job: what they should look up or compare, and the one thing they should notice first. If the purpose is missing, infer it from the data and say so. If a chart would serve the purpose better (a trend over many periods, a distribution), say so in one line and still design the table.
  2. Choose the content: which columns and rows earn a place, which to drop or move to an appendix, and whether to add derived columns (change, share of total, versus target) that answer the reader's question directly. Aim for no more than about seven columns on a slide.
  3. Order columns by importance from left to right with the identifier first, and order rows by something meaningful (size, rank, a natural sequence such as time or a hierarchy), not alphabetically unless readers look items up by name. Put totals at the bottom (or top for summaries) and set them apart.
  4. Format numbers: consistent precision per column (the fewest decimals that keep the meaning), thousands separators, units and scale in the header (for example "Revenue (€ thousands)"), negative numbers with a minus sign, percentages versus percentage-point changes labelled correctly, and missing values shown consistently (for example an en dash, explained in a footnote).
  5. Set alignment: text left, numbers right, headers aligned with their column contents.
  6. Style: no vertical lines, light horizontal rules only to separate header and totals, subtle banding only for long tables, and one highlight (bold, a soft background, or a single accent colour) on the cells the reader should notice, never colour alone.
  7. Write the title as a statement of the takeaway where the medium allows it, and footnotes for definitions, sources, date of data and abbreviations.
  8. Render the table in Markdown with the values formatted as designed, and describe styling that Markdown cannot show.
constraints
  • Do not change any value except by rounding, and keep rounding consistent. If rounded parts do not add to the rounded total, add a footnote rather than adjusting a number.
  • Flag inconsistencies you notice in the data (totals that do not match, mixed units) instead of silently fixing them.
  • Keep labels short and plain; spell out abbreviations in a footnote.
output format

Purpose

Reader's job and the first thing they should notice.

Design decisions

Bullets: content, order, formats, alignment, highlight, each with a short reason.

Table

The title, then the Markdown table, then styling notes.

Footnotes

Variant

One line on how the table would change for the other medium (slide versus report).

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
Data analysis
category
Data visualisation
level
Beginner
made for
Data analyst, Business analyst, Financial analyst, Researcher / scientist
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 design-data-table --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill design-data-table -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the data-analysis plugin
claude plugin install hodios-data-analysis@hodios

The plugin brings every entry in this domain at once.

PromptData visualisation

Choose a chart type

Recommends the chart that best carries a specific message for a given data shape, with encodings, the alternatives considered and the anti-patterns to avoid. Use before building a chart.

choose-chart-type
PromptReporting

Write an insight report

Turns analysis results into a decision-oriented report with a headline finding, evidence, caveats and a recommendation. Use when you need to share an analysis with people who will act on it.

write-insight-report
PromptReporting

Write a monthly business review

Writes a monthly business review with headline results, performance against plan by area, drivers, outlook, risks and the decisions needed from leadership. Use as an analyst or operations leader.

write-monthly-business-review
PersonaData exploration

Data analyst

Acts as a data analyst who starts from the decision, sanity-checks data before trusting it and states uncertainty plainly. Use as a standing analyst persona or subagent for data questions.

data-analyst
PromptData visualisation

Audit an existing dashboard

Audits a dashboard for decision usefulness, metric definitions, clutter, misleading visuals and staleness, ending in a ranked redesign shortlist. Use when a dashboard is ignored or distrusted.

audit-dashboard
RuleData visualisation

Chart design rules

Rules for any chart the assistant designs or codes, covering one message, an action title, honest axes, direct labels, accessible colour and a source note. Load whenever a chart or plot is made.

chart-design-rules