compare-docs

Compare two documents semantically and output structured JSON diffs of claims and relationships.

101|2|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/cowwoc/cat --skill compare-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: compare-docs
Source: https://github.com/cowwoc/cat/tree/main/plugin/skills/compare-docs
Command: npx skills add https://github.com/cowwoc/cat --skill compare-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables semantically comparing two documents to reveal content differences and structural changes while preserving inter-document relationships, enabling precise impact assessment.

Core Features & Use Cases

  • Independent extraction of semantic claims from each document and relationship graphs.
  • Side-by-side comparison of claim sets and relationship graphs to identify shared, unique, and modified elements.
  • Deterministic scoring of execution equivalence, highlighting critical relationship changes and graph topology differences.
  • Suitable for technical specifications, policy documents, and multi-document references where exact reasoning traceability matters.

Quick Start

  1. Provide two documents to compare, for example docs/a.md and docs/b.md.
  2. Run the compare-docs tool with: /compare-docs docs/a.md docs/b.md
  3. Review the structured JSON output detailing shared claims, relationships, dependency graphs, and warnings.

Frequently Asked Questions about compare-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I semantically compare two technical specification documents?

Semantic document comparison extracts claims and relationship graphs from each document independently, then outputs a structured diff identifying shared, unique, and modified elements to reveal content and structural changes.

What is execution equivalence scoring in document comparison?

Execution equivalence scoring deterministically compares relationship graph topology differences between two documents, highlighting critical relationship changes to produce a machine-readable impact assessment.

Can I compare policy documents to identify structural relationship changes?

Yes, comparing policy documents identifies structural relationship changes by extracting and comparing inter-document relationship graphs, preserving traceability for precise impact assessment.

How do I generate a machine-readable diff from multi-document references?

Generate a machine-readable diff from multi-document references by applying parallel extraction to independently pull semantic claims from each source, yielding deterministic structured JSON output.

Does semantic document comparison preserve inter-document relationships?

Yes, semantic document comparison preserves inter-document relationships by mapping and comparing relationship graphs alongside claim sets, ensuring structural topology differences are tracked in the final diff output.

What is the best way to assess the impact of changes between two versions of a document?

The best way to assess the impact of changes is to semantically compare the documents to generate a deterministic diff of modified claims and relationship graph topology differences for precise impact assessment.