hermes

Format a document for scanning

Restructures a long unformatted document with headings, lists, tables and a summary line so it can be scanned, without changing the wording beyond joins and labels.

context

Most readers scan before they read: they look at headings, the first words of paragraphs, lists and tables to decide what matters to them. A wall of text hides steps, deadlines and comparisons that formatting would make obvious. This job is formatting only. The author has approved the words, so the value is in exposing the structure that is already there: steps become numbered lists, parallel items become bullets, attributes compared across items become a table, and each section gets a heading that says what it covers.

task

Format this document for scanning, as .

document

  1. If the document is empty, ask for it and stop. If it is short (under about 150 words) or already well structured, say so, make only the changes that clearly help, and do not add headings for their own sake.
  2. Map the content: topics and where each starts and ends, sequences of steps, lists of parallel items, comparisons of several items across the same attributes, and key facts a reader hunts for (dates, deadlines, amounts, contacts, decisions, actions).
  3. Plan the structure:
  • headings at no more than three levels, each a short label of what follows ("How to apply", "Fees and deadlines");
  • numbered lists for sequences, bullets for unordered items, a table only when at least two items share at least two attributes;
  • keep the original order of content. If a different order would clearly help, suggest it instead of doing it.
  1. Add one summary line at the top that states the document's main point or action, built from the document's own words where possible, labelled "Summary:".
  2. Apply the structure. The only wording changes allowed are: headings and table labels, the summary line, and the joins needed to turn prose into list items or table cells (removing "and", "firstly", "also"; splitting a sentence at a list boundary; dropping a lead-in that a heading now replaces).
  3. Verify: every sentence and fact in the original appears in the output. Log every wording change.
constraints
  • Do not cut, add, reorder or rephrase content beyond the allowed joins and labels. Do not fix grammar or tone; list obvious errors under Suggestions instead.
  • Bold only what a scanning reader must not miss (a deadline, a required action), at most once or twice per section.
  • Formats:
  • markdown: # headings, - and 1. lists, pipe tables;
  • plain: headings on their own line in sentence case followed by a blank line, - and 1. lists, tables as aligned text columns;
  • word-style: start each block with the style to apply in square brackets, such as [Title], [Heading 1], [Heading 2], [List Bullet], [List Number] or [Normal], and give tables as [Table] followed by rows with cells separated by " | ", the first row marked as the header row.
output format

Formatted document

The document in the chosen format.

Structure notes

Bullets: what became headings, lists and tables, in one line each.

Wording changes

A table: Original wording | New wording | Why (heading, join, summary). Include the summary line.

Suggestions not applied

Bullets: reordering, cuts, unclear passages or errors the author may want to fix. "None" if none.

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
Writing and communication
category
Editing
level
Beginner
made for
Writer / author, People manager, Technical writer, Anyone, personal use
risk
read-only
version
v1.0.0 · incubating
reviewed
2026-10-03
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 format-document-for-scanning --target claude-code

This entry is in the full catalog, not the curated set the skills installer and plugins carry, so install it with the Hodios CLI.

pairs well with

All of Editing
PromptEditing

Edit a draft for structure

Edits a non-fiction draft at the structural level, covering argument, order, misplaced and missing sections, with a reverse outline and a prioritised revision plan instead of line edits.

edit-for-structure
PromptEditing

Edit a document for accessibility

Edits a Word, Google Docs, PDF-bound or web document for accessible reading, covering heading structure, link text, plain language, tables, reading order and alt-text placeholders.

edit-document-for-accessibility
PromptEditing

Tighten prose

Tightens prose by cutting filler, redundancy and weak verbs toward a target reduction while keeping the author's voice, meaning and necessary qualifiers, and reports what it cut.

tighten-prose
PersonaEditing

Editor

Editor who serves the reader and the author's intent, edits at the right level with structure before lines, and explains every change so the author can accept, reject or learn from it.

editor
PromptEditing

Proofread a text

Corrects grammar, spelling, punctuation and consistency errors in the chosen English variety, preserving the author's voice, and lists each change with the rule behind it.

proofread-text
PromptEditing

Rewrite a text for tone

Rewrites a text in a target tone or register, such as warmer, firmer or more formal, without changing its facts, asks or commitments, and shows which tone dials moved.

rewrite-for-tone