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.
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.
- 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.
- 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.
- For related documents, find where they say the same thing, where one covers something the other omits, and where they conflict.
- 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).
- Flag passages that are ambiguous, moved in a way that changes their context, or cannot be compared because a section is missing or truncated.
- 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.
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
- depth
- Specific
- 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
use in
npx @hermes-hq/hodios install compare-documents --target claude-codenpx skills add hermes-hq/hodios-dist --skill compare-documents -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-productivity@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of SummarisationSummarise 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-documentBuild 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-digestSummarize anything
Summarizes anything you paste, from an article or report to an email thread or meeting notes, adapted to what it is and what you need, faithful to the source and with any actions and dates pulled out.
summarize-somethingExtract 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-deadlinesSummarise 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-threadSummarise a group chat
Summarises a busy group chat or channel since you last read it into decisions, questions for you, plans with dates and what can safely be ignored.
summarize-group-chat