hermes

Compare two documents

Compares two versions of a document, or two related documents, and reports what changed, what stayed consistent and what conflicts, with quotes and locations for every finding.

context

Reviewers comparing documents miss the changes that matter most: a number edited in the middle of a paragraph, a "must" softened to "should", a clause deleted rather than reworded, or two related documents (a policy and its FAQ, a proposal and its contract, a spec and its summary) that quietly contradict each other. You compare meaning, not just wording, and you show your evidence with short quotes so the reader can check every finding.

document a

document b

task
  1. Decide the relationship and state it: two versions of the same document (A older, B newer, unless the text says otherwise), or two related documents that should agree. If it is unclear, say which reading you took.
  2. For versions, find every substantive change: added, removed, moved and modified content. Prioritise changes in meaning: numbers, dates, amounts, names, obligations (must, shall, may, should), scope, conditions and exceptions, deadlines, and negations. Group pure wording or formatting changes into a single line instead of listing each.
  3. For related documents, find where they say the same thing, where one covers something the other omits, and where they conflict.
  4. Rate each finding's impact: High (changes what someone must do, pay, deliver or may rely on), Medium (changes emphasis, scope or clarity), Low (wording).
  5. Flag passages that are ambiguous, moved in a way that changes their context, or cannot be compared because a section is missing or truncated.
constraints
  • Quote short fragments from both documents for every High and Medium finding and give the section, heading or paragraph where it appears.
  • Report differences; do not judge which version is better unless asked, and do not invent the reason for a change.
  • Do not paraphrase numbers or obligations; quote them.
  • If either document looks truncated or the two are unrelated, say so before comparing.
  • For legal or financial documents, this is a reading aid; say once that anything with consequences should be checked by the person responsible or a professional.
output format

Relationship

One line.

Summary

Three to five bullets: the changes or differences that matter most.

Changes or differences

A table: Impact | Location | A says | B says | What it means. Sorted High first.

Conflicts

For related documents: bullets with quotes from both. For versions: write "Not applicable".

Consistent

One or two lines on what is unchanged or agrees, so the reader knows what they can skip.

Needs a closer look

Bullets for ambiguous, moved or truncated parts.

2 required values still a placeholder; the assistant will ask for them.

details

kind
Prompt: a task you run by name to get one finished thing back
domain
Productivity and personal life
category
Summarisation
level
Beginner
made for
Editor, Writer / author, Consultant / freelancer, Project / program manager
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 compare-documents --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill compare-documents -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the productivity plugin
claude plugin install hodios-productivity@hodios

The plugin brings every entry in this domain at once.

pairs well with

All of Summarisation
PromptSummarisation

Summarise a long document

Produces a layered summary of a long document, from one line to key points to section detail, keeping numbers, hedges and nuance faithful and pointing to where each point comes from.

summarize-long-document
PromptSummarisation

Build a news digest

Turns several articles into a short briefing - key developments, where sources agree or disagree, what is genuinely new and what to watch next - with every point traced to its source.

build-news-digest
PromptSummarisation

Extract deadlines and dates

Extracts every date, deadline, appointment and time-bound obligation from letters, emails, syllabi or contracts into a sorted calendar-ready list, quoting the source line.

extract-deadlines
PromptSummarisation

Summarise a book

Summarises a non-fiction book's argument, key ideas, evidence and critiques, and turns it into actions for your purpose. Says when it does not know the book instead of inventing content.

summarize-book
PromptSummarisation

Summarise an email thread

Summarises a long email thread into where things stand now, the decisions made, open questions and who owes what to whom, so you can catch up or reply in minutes.

summarize-email-thread
PromptSummarisation

Summarise a video or podcast transcript

Summarises a video or podcast transcript into key points with timestamps, exact quotes and a verdict on which parts are worth watching in full, without inventing times or claims.

summarize-video-transcript